Skip to content

Capstan v0.1.0

Choose a tag to compare

@github-actions github-actions released this 27 Jul 07:48
· 122 commits to main since this release

Capstan v0.1.0

The first packaged release of Capstan: a small, inspectable terminal coding
agent with a native C core and an embedded Lua runtime.

Install

curl -fsSL https://raw.githubusercontent.com/theStrangeAdventurer/capstan/main/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"

Then start the TUI with an API key:

OPENAI_API_KEY=... capstan

Or run a one-shot task:

OPENAI_API_KEY=... capstan run --prompt "Inspect this repository"

The installer selects the correct archive and verifies it against the published
SHA256SUMS file before installation. Set CAPSTAN_INSTALL_DIR to change the
destination or CAPSTAN_VERSION=v0.1.0 to pin this release.

Prebuilt platforms

  • Apple Silicon macOS (arm64)
  • Linux (x86_64)
  • Linux (arm64)

Each archive contains the executable plus LICENSE, NOTICE, and
THIRD_PARTY_NOTICES.

Highlights

  • Single native executable with ncurses and Lua linked from vendored sources
  • OpenAI-compatible providers configured in Lua
  • Human slash commands and model-callable tools backed by the same plugin system
  • Explicit allow, ask, and deny decisions for model-initiated tools
  • Headless capstan run mode for scripts and agent evaluations
  • Hot-reloadable user plugins, hooks, skills, and MCP support

Current limitations

  • No Windows or Intel macOS prebuilt binary yet
  • A system libcurl is still required at runtime
  • User Lua plugins are trusted code and are not sandboxed

See the repository README for source-build instructions, provider configuration,
permissions, and plugin examples.