Repository navigation
Capstan v0.1.0
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=... capstanOr 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 runmode 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
libcurlis 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.