Acai.sh CLI

The acai Command-line Interface helps you (or your agent, or script) perform common actions related to spec-driven development with Acai.

Primarily, it is used to push and pull specs and metadata to an acai server, and to read implementation status and notes from the server as well.

It works with our official hosted server, or your own self-hosted instance.

For Quickstart, docs and tutorials see https://acai.sh.

Install

The CLI is available on NPM as a JavaScript bundle.

npm i -g @acai.sh/cli

The release pipeline verifies the packed npm artifact through the installed acai command under a real Node runtime before publishing.

If you don't have a JavaScript runtime, we have macOS and Linux releases available on GitHub.

Install from release

You can install a standalone binary directly from a GitHub release asset. For example, on Linux x64:

curl -fL https://github.com/acai-sh/cli/releases/download/<version>/acai-linux-x64 -o acai
chmod +x acai
sudo mv acai /usr/local/bin/acai
acai --help

If you prefer a user-local install without sudo:

mkdir -p "$HOME/.local/bin"
curl -fL https://github.com/acai-sh/cli/releases/download/<version>/acai-linux-x64 -o "$HOME/.local/bin/acai"
chmod +x "$HOME/.local/bin/acai"
"$HOME/.local/bin/acai" --help

Project overview

The CLI is written in TypeScript with bun and commander. It is aligned to the Acai.sh API using openapi-fetch and openapi-typescript.

Local development

The repo includes a .devcontainer.json so you can get up and running quickly. devpod cli is recommended but not required.

# from cli repo root
devpod up .

If you don't have devpod, you can open the repo in Zed/VSCode and click "open in devcontainer".

License

Apache 2.0. Contributors must sign a Contributor License Agreement. You are free to use, modify, and distribute this software, including for commercial purposes, under the terms of the license.

Security

See our security checklist to understand how we protect this project and our users.