🧸 Teddy — AI Agent CLI

Zero-dependency coding agent. Supports Anthropic & OpenAI-compatible APIs (OpenAI, Groq, OpenRouter, Ollama, DeepSeek, etc.).

🚀 Quick Install

npm (global)

npm install -g teddy-ai

curl (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/itshaiheree/teddy/main/install.sh | bash

PowerShell (Windows)

irm https://raw.githubusercontent.com/itshaiheree/teddy/main/install.ps1 | iex

⚙️ Configuration

Create .env in C:\Users\<user>\.teddy\. You can also put it in folder your project directory or set environment variables with this template:

# Provider: "anthropic" or "openai"
PROVIDER=openai

# OpenAI-compatible (OpenAI, Groq, DeepSeek, Ollama, OpenRouter, etc.)
OPENAI_BASE_URL=https://api.openai.com/v1
OPENAI_API_KEY=sk-...
MODEL=gpt-4o

# Or Anthropic
# PROVIDER=anthropic
# ANTHROPIC_API_KEY=sk-ant-...
# MODEL=claude-sonnet-4-6

# If you wish to provide a custom system prompt, you can enter it here! By default, Teddy comes with a built-in system prompt, so you are not required to provide this enviroment.
# SYSTEM_PROMPT="Kamu adalah sebuah boneka beruang raksasa berukuran 3.5 kaki"

🎮 Usage

Interactive mode (REPL)

teddy

One-shot mode

teddy "Buat file hello.js lalu jalankan"

⌨️ Commands

| Command | Description | |---------|-------------| | :help / CTRL+H | Show help | | :exit / :quit / CTRL+E | Exit (auto-saves session) | | :clear / CTRL+L | Reset current conversation | | :new / CTRL+N | Save current session & start new | | :sessions / CTRL+O | Open session picker |

💾 Sessions

• All sessions are saved automatically to ~/.teddy/sessions/
• Press CTRL+O or type :sessions to browse, load, or delete sessions
• Arrow keys to navigate, Enter to select, Esc to cancel
• Sessions persist across restarts

🔧 Dev

git clone https://github.com/username/teddy.git
cd teddy
npm install
npm run dev        # Run with ts-node
npm run build      # Compile TypeScript

📋 Requirements

• Node.js >= 18 (uses native fetch)

📄 License

MIT