@agentskit/cli

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

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