alysis-code 0.14.0

Local CLI coding agent that turns plans into reviewed, PR-ready code.
Bring your own model. Sandboxed by default.

Website · Docs · Changelog

Get Started

Alysis Code requires Python 3.11+ and runs on macOS, Linux, and Windows.

1 — Install

pipx install alysis-code

2 — Launch in your project

cd your-project
alysis-code

The first run opens a guided setup wizard: choose Use an API key or Use an AI subscription, connect a provider, and pick your default model. Re-run it anytime with alysis-code setup. (alysis works too, as a short alias.)

3 — Start building

alysis-code chat                            # interactive coding session
alysis-code run "Fix the failing tests"     # one-shot task

Bring your own key from any supported provider — or point Alysis Code at a local endpoint (Ollama, LM Studio, vLLM) and run fully offline. The /config picker lists every preset. Full walkthrough: Quickstart guide.

Why Alysis Code

• Easy to use — a full coding agent behind a clean, convenient terminal interface that anyone can pick up and play with in minutes: slash commands, interactive pickers, and live status built in.
• Built for every developer — from solo scripts to team servers and CI, the same agent fits every workflow.
• Forge Mode — plan-driven execution for larger work: plan, dispatch parallel workers, verify each task, ship PR-ready code.
• Orchestrated subagents — isolated workers run in parallel, verification is pinned to their exact candidates, and changes apply only after host-side conflict checks.
• Free built-in web search — model-independent web_search that works with any provider, at no extra cost.
• Bring your own model — OpenAI, Anthropic, DeepSeek, Qwen, Gemini, Mistral, Xiaomi MiMo, OpenRouter, xAI, and more — plus local endpoints (Ollama, LM Studio, vLLM) for fully offline use.
• Deeply extensible — skills, custom tools, MCP servers, hooks, subagents, and plugins, bundled in one declarative manifest.
• Sandboxed by default — Docker or Bubblewrap isolation with an always-on denylist that refuses rm -rf /, curl | sh, and sudo — even in fullaccess.

Shell and verification commands default to strict sandboxing. Verification can run outside that sandbox only when explicitly configured with verify_sandbox.mode="off" or ALYSIS_VERIFY_SANDBOX_MODE=off.

Permissions & Personas

Two layers control what the agent may do — one enforces, one focuses.

Permissions are the enforcement layer. Choose one per command with --mode, select the next message's level in chat with /permissions or Shift+Tab, or set a default with alysis-code config set default_mode <mode>. A selection takes effect when the next user message starts; it does not change a turn already running:

Personas are working postures layered on top. Switch with /persona, or cycle with Tab in the TUI:

A persona is a convention, never a permission: it can keep or lower your execution mode, but can never raise it. Define your own in .alysis_personas/*.md. Learn more

Use /persona architect for planning in chat, or /forge for a plan-driven execution workflow. The former chat /plan commands have been removed; Forge retains its plan views and editor. Persona changes made during a running turn apply after that turn finishes.

Project Links

• Website
• Documentation — also mirrored in docs/
• Changelog
• Contributing — local setup and PR expectations
• Security policy — report vulnerabilities privately, never through public issues

License

Apache-2.0. You're free to use, modify, and distribute this code, including commercially, as long as you keep the attribution and license notices. See LICENSE and NOTICE.

FAQ

More questions? See the full FAQ.

Join the community — X | GitHub Issues