@agentskit/cli

The programmatic package entry is ESM-only because its Ink 7 UI dependency uses an ESM graph with top-level await.

Profile: major-package

Chat with any LLM, scaffold projects, and run agents — all from your terminal.

Tags: ai · agents · llm · agentskit · openai · anthropic · claude · gemini · chatgpt · cli · command-line · scaffolding · ai-agents · autonomous-agents

Verified proof

• Package metadata and tests live under packages/cli/.
• Package guide: https://www.agentskit.io/docs/packages/cli
• Stability map: docs/STABILITY.md

How this fits the ecosystem

@agentskit/cli is the fastest path from terminal to working agent: scaffold projects, chat, run agents, inspect config, and diagnose setup.

• AgentsKit: compose it with the other packages in this repo to build agents from small, swappable parts.
• Registry: look for ready agents and templates that already use this layer at registry.agentskit.io.
• Playbook: learn the production patterns behind this layer at playbook.agentskit.io.
• AKOS: run the same concepts with enterprise deployment, governance, and observability at akos.agentskit.io.

Docs: package guide · agent handoff

Why cli

• Zero setup for prototyping — go from idea to running conversation in under a minute; no boilerplate, no config files to write
• Scaffold production-ready projects — generate a React chat app or terminal agent with the right structure so you skip the boring setup
• Script and automate — pipe inputs, use env vars for keys, and compose with other Unix tools for lightweight agent scripting
• Every provider, one command — switch between OpenAI, Anthropic, Ollama (local), and more with a single flag

Install

npm install -g @agentskit/cli

Quick example

# Chat with Claude instantly
ANTHROPIC_API_KEY=... agentskit chat --provider anthropic --model claude-sonnet-4-6

# Chat with a local model (no API key needed)
agentskit chat --provider ollama --model llama3.1

# Scaffold a new React chat app
agentskit init --template react --dir my-app

# Scaffold a terminal agent
agentskit init --template ink --dir my-cli

# Run a headless agent (same building blocks as the CLI)
agentskit run --help

agentskit init

Features

• agentskit chat — interactive streaming chat in the terminal powered by @agentskit/ink
• agentskit init — interactive project generator (React or Ink templates, production-ready structure)
• agentskit run — execute headless runtime agents from the terminal
• agentskit doctor — diagnose your environment, packages, and provider config
• agentskit dev — hot-reload agent development
• agentskit tunnel — expose local agent via public URL
• agentskit rag index — chunk + embed files into a file-backed vector store
• agentskit config — print merged config or scaffold a template
• Extensibility — plugins (slash commands, tools, skills, providers, hooks, MCP servers), permission policy with modes, lifecycle hooks (shell or JS), MCP stdio bridge, session rename + fork, /usage + /cost
• Provider flags: --provider, --model, --system, --skill, --memory, --mode, --plugin-dir
• Env-var based key injection — works seamlessly in CI and scripts

Full reference: docs/infrastructure/cli · ARCHITECTURE.md

agentskit doctor

Ecosystem

| Package | Role | |---------|------| | @agentskit/runtime | createRuntime — agents outside the CLI | | @agentskit/adapters | All chat / run providers | | @agentskit/ink | Ink UI used by interactive chat | | @agentskit/core | Shared types and contracts |

Contributors

License

MIT — see LICENSE.

Docs

Full documentation · GitHub

Quick start

import '@agentskit/cli'
console.log('@agentskit/cli loaded')

Maturity and compatibility

• Stability: beta — see docs/STABILITY.md
• Node.js 20+ and TypeScript strict mode
• Published as @agentskit/cli

Contributing

See CONTRIBUTING.md and the monorepo LICENSE.