Reference

Configuration

Taxiway separates installed runtime assets from mutable user state.

Runtime Assets

Release installs place runtime assets under:

~/.taxiway/runtime

The runtime directory contains files needed to create labs:

  • infra/
  • agents/
  • orchestrators/
  • infra/observability/langfuse.compose.yml
  • infra/gateway/litellm/models.yaml

Override it with TAXIWAY_RUNTIME_DIR when developing from a source checkout.

Lab State

Lab state defaults to:

~/.taxiway/lab-state

Override it with --state-dir <path> or TAXIWAY_LAB_STATE_DIR.

When running Taxiway from a source checkout, an .envrc redirects all state paths into the checkout — see Development.

Drivers

Taxiway supports:

DriverRequirement
limalimactl available on PATH
dockerdocker on PATH and daemon

Force a driver for one command:

taxiway up mylab --driver docker

Set a default driver for the shell:

export LAB_DRIVER=docker
taxiway up mylab

Driver resolution order is:

  1. --driver <name>
  2. LAB_DRIVER
  3. auto-detection: Lima when limactl is available, then Docker

See Drivers for Lima and Docker details.

Gateway

Taxiway starts host-local gateway pieces automatically from lab commands such as taxiway up, taxiway run, and taxiway gateway <lab>. The gateway path uses the shared proxy plus one LiteLLM sidecar per lab.

Lab-specific gateway state lives under each lab:

~/.taxiway/lab-state/<lab>/gateway

Converted provider auth used by gateways lives under:

~/.taxiway/auth

See Gateway.

Observability

Taxiway can manage an optional Langfuse observability stack:

taxiway observe up
taxiway observe open

Initialize the full host-local runtime with:

taxiway init

taxiway init starts the shared proxy and Langfuse. It does not create a lab.

Langfuse is exposed through the Taxiway proxy at http://langfuse.localhost:<proxy-port>. The observability Compose stack does not publish its own host ports.

Mutable observability state lives under:

~/.taxiway/observability

Proxy state lives under:

~/.taxiway/proxy

See Observability.

Shell Completion

Generate completion for the installed CLI:

taxiway completion zsh > ~/.zsh/completions/_taxiway
taxiway completion bash > ~/.bash_completion.d/taxiway
taxiway completion fish > ~/.config/fish/completions/taxiway.fish