preloader
blog post

Introducing Calliope CLI: Open Source Multi-Model AI for Your Terminal

author image

Your Terminal Just Got Superpowers

Today we’re releasing Calliope CLI as open source. It’s a multi-model AI agent that lives in your terminal, works with 12+ AI providers, and remembers your projects across sessions.

No more switching between ChatGPT, Claude, and Gemini in browser tabs. No more copy-pasting code back and forth. Just one command:

npm install -g @calliopelabs/cli
calliope

And you’re talking to the world’s best AI models from your terminal.

Why We Built This

We kept watching developers do the same dance: copy code from editor, paste into ChatGPT, copy response, paste back, realize it needs context, go back to ChatGPT, explain the context… repeat forever.

The terminal is where developers live. AI should meet them there—with full access to files, git history, and project context.

That’s Calliope CLI.

12+ AI Providers, One Interface

Switch between providers instantly. No config changes. No new tools.

/provider anthropic    # Claude Sonnet 4, Opus, Haiku
/provider openai       # GPT-4o, o1, o3-mini
/provider google       # Gemini 2.0 Flash, Pro
/provider mistral      # Mistral Large, Codestral
/provider groq         # Llama 3.3 at lightning speed
/provider deepseek     # DeepSeek Coder, Reasoner
/provider ollama       # Run anything locally

Already paying for API keys? Use them. 100% BYOK (Bring Your Own Keys)—no middleman, no markup.

Intelligent Model Routing

Not sure which model to use? Let Calliope decide:

/route on

Now Calliope automatically selects the right model for each task:

  • Simple questions → Fast models (Haiku, GPT-4o-mini)
  • Moderate complexity → Balanced models (Sonnet, GPT-4o)
  • Complex reasoning → Powerful models (Opus, o1)

Optimize for cost and quality without thinking about it.

Tools That Actually Work

Calliope doesn’t just chat. It does things.

ToolWhat It Does
shellRun any command
read_file / write_fileRead and modify your code
execute_codeRun Python, Node, Bash in a sandbox
gitCommit, push, diff—safely
web_searchLook up docs and solutions
mermaidGenerate diagrams

Ask it to “fix the failing tests” and watch it run the tests, read the errors, modify the code, and verify the fix—all autonomously.

Parallel Execution

Independent operations run in parallel automatically:

[Executing 3 tools in parallel]
├── [git] status
├── [shell] npm test
└── [read_file] package.json

2-5x faster than sequential execution.

Autonomous Loops: Set It and Forget It

This is where it gets interesting. Ask Calliope to do something complex:

/loop "Refactor all TypeScript files to use strict mode. Run tsc after each change. Output DONE when there are no errors." --max-iterations 30

Calliope will iterate autonomously:

  1. Find a file to refactor
  2. Make the change
  3. Run the compiler
  4. If errors, fix them
  5. Move to the next file
  6. Repeat until done

You can walk away and come back to a completed task.

Project Memory That Persists

Create a CALLIOPE.md file in your project:

/memory init
/memory add context "This is a TypeScript monorepo using pnpm"
/memory add preference "Use functional components with hooks"

Now every session starts with that context. No more re-explaining your project structure.

Calliope also automatically loads context from:

  • README.md, ARCHITECTURE.md
  • .cursorrules, .github/copilot-instructions.md
  • CLAUDE.md (if you’re already using Claude)

Your AI finally understands your codebase.

Security Built In

We didn’t build this to let AI run wild on your system.

Scope Management:

/scope add ~/projects/myapp    # Allow access
/scope remove /tmp             # Restrict access

Risk Assessment: Every operation is classified by risk level. High-risk commands (rm, git push, chmod) require confirmation unless you explicitly enable god mode.

Sandboxed Code Execution: The execute_code tool runs in Docker containers with resource limits, timeouts, and network isolation.

Three Modes for How You Work

ModeWhat It Does
PlanChat only, no execution. Design before you build.
HybridSmart planning before complex operations. (Default)
WorkDirect execution. For when you know what you’re doing.
/mode plan     # Discuss architecture
/mode work     # Ship the feature

Save and Switch Contexts

Configuration Profiles:

/profile save work        # Save current settings
/profile save experiments # Different settings
/profile work             # Switch instantly

Conversation Branching:

/branch new "try-redis"   # Fork the conversation
/branch switch main       # Go back to original

Explore different approaches without losing context.

Cost Tracking

Know what you’re spending:

/cost

See token usage and costs by provider, session, and cumulative totals. No surprises.

Open Source. MIT License.

The code is on GitHub. Read it, fork it, contribute to it.

github.com/calliopeai/calliope-cli

git clone https://github.com/calliopeai/calliope-cli

We believe AI development tools should be open. The community makes them better.

Get Started in 60 Seconds

Install:

npm install -g @calliopelabs/cli

Run:

calliope

Configure: The setup wizard guides you through selecting a provider and entering your API key. Or just set environment variables:

export ANTHROPIC_API_KEY=sk-ant-...
export OPENAI_API_KEY=sk-...
calliope --skip-setup

Start building:

> Help me write tests for the auth module
> Fix the TypeScript errors in src/
> Explain what this regex does
> Refactor this function to use async/await

What’s Next

We’re actively developing:

  • More providers as they become available
  • Plugin system for custom tools
  • MCP server support for external tool integration
  • AgentSkills marketplace

Star the repo. Open issues. Send PRs. Let’s build this together.

View on GitHub →

Read the Docs →

Related Articles