Gets smarter with every session

curie-agent

Local-first, open-source agent with compounding memory.


npm install -g @curie-agent/cli

Multi-provider · Safety guards built in

Docs Apache-2.0 Node.js ≥ 20 TypeScript pnpm monorepo

Four Pillars

One binary, one config, one TUI. Everything you need, nothing you don't.

Everyday Assistant

Telegram gateway is live. Slack, Discord, voice, webhooks, and more coming in a future release. Your agent, always on call.

Coding Agent

Turn loop with tools (Read, Edit, Write, Glob, Grep, Bash), MCP client, plan mode, safety guards (path + command + snapshots), and Codex-style approval tiers.

On the way

Compounding Wiki

Markdown-on-disk knowledge graph with Ingest, Query, and Lint workflows. Persistent memory that compounds over time.

On the way

Multi-Session Orchestrator

tmux-like cockpit running N agent sessions in parallel panes with shared memory, queue, broadcast, and A/B diff comparison.

Ready Now

Every feature below ships with v0.2.4. No config required — just install and go.

Shipped

5 AI Providers

Anthropic, OpenAI, Google Gemini, Ollama, OpenRouter. Switch at runtime with /provider.

Claude 4 GPT-4o Gemini 2.5 llama3 openrouter
Shipped

9 Built-in Tools

Read, Edit, Write, Glob, Grep, Bash, WebSearch, WebFetch, Reminders — all with Zod-validated schemas.

Read Edit Bash Web
Shipped

4 Approval Modes

Plan (read-only, writes only under plans/), Edit (auto-edits, asks shell), Auto (LLM harm-check per call), Yolo (no prompts). Legacy aliases: manual→plan, auto-edit→edit, full-auto→auto.

/mode codex-style
Shipped

24 Slash Commands

/model, /theme, /effort, /tools, /websearch, /remind, /cron, /context, /stats, /mcp, /heartbeat, /snapshots, /revert, /exit, and more.

/status /agent /channels
Shipped

MCP Client

Connect to MCP servers via stdio, SSE, or streamable-HTTP. Auto-discovers tools. Manage with /mcp commands.

stdio sse http
Shipped

Telegram Gateway

Control your agent from Telegram. Inline approval buttons, per-chat sessions, group support.

polling inline keys groups
Shipped

Interactive Init Wizard

Step-by-step setup: choose provider, set API key, pick model, create identity files (SOUL.md, USER.md, AGENTS.md).

/init identity auto-config
Shipped

Cron & Reminders

Natural language reminders ("remind me in 30 min"), scheduled cron tasks, heartbeat system for autonomous cycles.

/remind /cron heartbeat
Shipped

8 Themes + 5 TUI Tabs

Tokyo Night, Nord, Dracula, Solarized, Gruvbox, Black, White, Grey. Chat, Stats, Projects, Agents, Channels.

/theme ink stats
Shipped

Git Snapshots

Before each turn in yolo mode, a dangling git commit is created. /snapshots lists them, /revert restores. Never lose work again.

/snapshots /revert git-stash

Your Agent, On a Schedule

Set up autonomous heartbeat cycles — the agent checks in, reviews your workspace, and updates your TODO.md while you sleep.

Heartbeat System

Shipped
Schedules
Intraday 8:10, 10:10, 14:20, 16:20 Active
Daily 6:00 Active
Weekly Monday@6:00 Active
Monthly 1@6:00 Active
What it does
  • Reads MEMORY.md, USER.md, AGENTS.md, TODO.md
  • Updates project status and tracks progress
  • Runs in yolo mode — no approval prompts
  • Delivers results to configured channels
Commands
/heartbeat status
/heartbeat enable
/heartbeat daily 6:00
/heartbeat now

Roadmap

Phases 0–2 are complete. Here's what's next.

Phase 3

MCP Server

Expose curie-agent tools, sessions, wiki, and channels to other AI agents.

Phase 3

Skills Runtime

Claude-Code-compatible SKILL.md files in ~/.curie-agent/skills/.

Phase 3

Subagents

Task tool with worktree isolation, .curie-agent/agents/*.md format.

Phase 3

Hooks & Plugin API

Pre/post hooks for tool calls and events. npm plugin packages.

Your Provider, Your Choice

No vendor lock-in. Switch models and providers at runtime with a single slash command.

Anthropic OpenAI Google Gemini Ollama OpenRouter

Add your own: @curie-agent/providers is a pluggable interface.

Up and Running in 30 Seconds

1. Install

npm install -g @curie-agent/cli

2. Launch

curie-agent

3. Configure

> /init

4. Ask anything

> write me a TypeScript utility for retry logic
curie-agent v0.2.4 · claude-sonnet-4-6 · auto-edit
 
> write me a TypeScript utility for retry logic with exponential backoff
 
I'll create a reusable retry utility with configurable delays and max attempts.
Let me create a retry.ts file with the implementation.
 
— 238 lines written · 3 files changed · tests passing —

Requires Node.js ≥ 20. Set ANTHROPIC_API_KEY or OPENAI_API_KEY to begin.