Getting Started

Wolli is a persistent, purposeful agent that runs in your terminal. It stays small at the core while being extended through TypeScript extensions, skills, prompt templates, themes, integrations, and plugins.

Quick start

Install Wolli with npm:

npm install -g wolli

Then create a new agent and start its first conversation:

wolli new <name>

The agent opens by asking what it is for. Answer conversationally; it interviews you, distills its purpose, and when you both agree it understands its job, it writes its own SOUL.md. Reconnect any time with wolli <name>.

Authenticate with /login for subscription/OAuth providers (Claude and others), or set an API key such as ANTHROPIC_API_KEY before starting wolli. Credentials persist to the shared ~/.wolli/agent/auth.json and are reused by every agent.

For the full first-run flow, CLI reference, sessions, and the agent-home layout, see the package README.

Customization

• Extensions - TypeScript modules for tools, commands, events, and custom UI.
• Skills - Agent Skills for reusable on-demand capabilities.
• Prompt templates - reusable prompts that expand from slash commands.
• Themes - built-in and custom terminal themes.
• Integrations - connect external services and message channels to the agent.
• Plugins - bundle, publish, and install extensions, integrations, skills, prompts, and themes.

Programmatic usage

• SDK - embed wolli in Node.js applications.