> ## Documentation Index
> Fetch the complete documentation index at: https://headgate.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Quickstart
> Run a typed job locally in Rust or Go without external services.
This quickstart uses headgate's in-memory test store. You will register a typed handler,
enqueue one job, run the real admission and dispatch path, and verify completion.
```bash Rust theme={"system"}
cargo run --manifest-path examples/rust/Cargo.toml --bin basic
```
```bash Go theme={"system"}
cd examples/go
GOWORK=off go run ./basic
```
Expected output:
```text theme={"system"}
welcome, Ada
... completed
```
## Build it yourself
```rust Rust theme={"system"}
#[derive(serde::Serialize, serde::Deserialize, headgate::Task)]
#[task(kind = "example:welcome", version = 1)]
struct Welcome { name: String }
```
```go Go theme={"system"}
type Welcome struct { Name string `json:"name"` }
func (Welcome) Kind() string { return "example:welcome" }
```
```rust Rust theme={"system"}
let mut registry = headgate::Registry::new();
registry.register::(|_ctx, task| async move {
println!("welcome, {}", task.name);
Ok(())
})?;
```
```go Go theme={"system"}
registry := headgate.NewRegistry()
err := headgate.RegisterFunc[Welcome](registry,
func(_ context.Context, job *headgate.Job[Welcome]) error {
fmt.Printf("welcome, %s\n", job.Args.Name)
return nil
})
```
A durable envelope supplies identity, routing, policy inputs, payload version, and retention.
The complete Rust and Go programs are available inside the
[basic worker example](/docs/examples/basic).
`testing::drain` and `Runner.Drain` execute the real admission, dispatch, and fenced ack path.
Use the in-memory store for handler and runtime tests. Use isolated live-store helpers when
the behavior depends on SQL, Lua, transactions, migrations, inspection, or notifications.
## Next steps