@aicraftalchemy/aiaca

AIACA — AI Agentic Coding Assistant

Production-grade agentic CLI that builds, edits, and ships code end-to-end.

npm install -g @aicraftalchemy/aiaca
aiaca

Features

• Multi-provider — Gemini (default, free tier), Claude (Anthropic), and OpenRouter (one key, 100s of models), with auto model routing per task (Gemini/Claude)
• 100+ tools — file ops, bash, web search, code intelligence, sub-agents, planning (47 exposed to the model; the rest drive slash commands)
• Full-stack capable — scaffold → backend → frontend → verify in one session
• 19 specialist agents — frontend designer, backend developer, fullstack engineer, security reviewer, and more
• Rich TUI — live task tree, inline diffs, plan panel, change ledger
• Persistent auth — set your key once with /login, stays until /logout
• Security-aware — SSRF-guarded fetch, secret redaction, prompt-injection firewall, and per-tool permission prompts

Quick Start

# Install
npm install -g @aicraftalchemy/aiaca

# Launch (first run prompts for your API key)
aiaca

# Free Gemini key: https://aistudio.google.com/apikey

Authentication

On first launch AIACA asks for your API key and saves it to ~/.aiaca/credentials.json.

/login    — set or update credentials
/logout   — remove saved credentials
/auth     — show which keys are active

Or use environment variables (CI/scripts):

export GEMINI_API_KEY=your-key
export ANTHROPIC_API_KEY=your-key

Key Commands

/model    — switch provider or model
/status   — session info, cost, context usage
/login    — update API credentials
/logout   — remove credentials
/auth     — authentication status
/help     — all available commands

Development

npm install
npm run dev          # run the TUI from source (tsx)
npm run typecheck    # tsc --noEmit (strict)
npm test             # core + per-tool unit tests
npm run test:ui      # Ink component tests
npm run audit:tools  # validate the tool registry (names, handlers, specialist refs)
npm run ci           # typecheck + all tests + build (what CI runs)
npm run build        # bundle to dist/cli.js (esbuild)

CI runs typecheck, tests, the tool-registry audit, and the build on Node 20 & 22 across Linux and Windows.

License

MIT AiCraftAlchemy