Bastion

Bastion deploys virtual computers for coding agents.

See the full documentation at bastion.computer.

Dev Environment

The following section is for setting up a local dev environment for contributing to the codebase.

Prerequisites

• mise for tool and task management.

All required runtimes, compilers, and build tools are managed by mise.toml; you do not need to install them globally.

Setup

Install the required tools and JavaScript dependencies from the repository root:

mise install

List available tasks:

mise tasks --all

Local Testing

Run the same checks used by CI from the repository root:

mise run format:check
mise run lint
mise run build
mise run typecheck
mise run test

Use format:write to rewrite formatting locally:

mise run format:write

Start local development services:

mise run dev:up

This opens a bastion-dev tmux session with separate panes for the core API, dev db explorer, docs site, and an interactive shell in the repository root.

To stop the dev environment, exit the panes or run mise run dev:down.

Bastion CLI Commands

With the dev server running, run CLI commands from a local dev build through mise:

mise run dev:bastion templates list

Examples:

mise run dev:bastion templates create --key dev-env --config '{"agents":{"opencode":{}},"actions":{"init":[]}}'
mise run dev:bastion env create --template-key dev-env
mise run dev:bastion env list

The task defaults to http://localhost:3148. Set BASTION_API_URL to target another host API:

BASTION_API_URL=http://localhost:3148 mise run dev:bastion templates list

Contact

Reach out to hazim@bastion.computer or join the Bastion GitHub discussions.