OuterBot Documentation

OuterBot is a transparent AI proxy that sits between you and any AI provider — Anthropic, OpenAI, Groq. It injects your project context automatically on every turn, compresses conversation history so sessions run forever, and routes to backup providers when you hit a limit. No install. No extension. Change two URLs and go.

Quick Start

Two URL changes. That's the entire setup.

1. Create an account — Sign up at outer.bot/signup. Free Community plan, no credit card required.
2. Get your URLs — Go to outer.bot/setup. Your personal AI proxy URL and git proxy URL are generated automatically.
3. Set your AI base URL — Paste your AI proxy URL into your IDE's settings. For Claude Code: one prompt configures it automatically. For Cursor/Windsurf: one field in Settings → AI.
4. Create a project — Open the OuterBot Workspace, click +, enter a project name. OuterBot creates a GitHub repo and wires the git proxy automatically.
5. Start working — Your AI now receives your project briefing on every message. No API key required — AI credits included on all plans.

Plans

OuterBot has two plans. Community is free forever. Pro adds managed AI with credits at cost — no markup, credits roll over forever.

Community (Free)

• AI proxy endpoint — works with any IDE
• Git proxy + managed GitHub repos
• Server-side project briefing injection
• Obie AI context filtering
• BYOK — bring your own API key, $0 markup
• OuterBot Workspace (ide.outer.bot)

Pro ($15/month or $150/year)

• Everything in Community
• Unlimited AI credits at our cost — zero markup, credits never expire
• All AI models — Claude Sonnet/Opus (Anthropic), GPT-4o (OpenAI), open source (Llama, Mistral, and more)
• No API key required — or bring your own (optional)
• Briefing sync — Guardian context synced to cloud
• Mobile chat — full AI chat from any phone or tablet
• OuterBot Workspace at ide.outer.bot
• Team collaboration — $8/mo per additional member
• Smart Routing — auto-route simple replies to a faster model
• Priority email support

See full pricing details →

OuterBot Workspace Pro

The OuterBot OuterBot Workspace is a full browser-based development environment available to Pro members. No installation required — code from any desktop browser. Open the OuterBot Workspace →

Features

• Monaco Editor — The same editor that powers VS Code, with syntax highlighting, IntelliSense, and keyboard shortcuts
• AI Chat Panel — Full agent chat with tool use, file editing, and live file preview as the agent works
• Plan Before Acting — Agent describes its plan and waits for approval before making changes. Same confirm/trust setting as the VS Code extension.
• Stop Button — Interrupt the agent mid-task at any time.
• Model Picker — Switch between Anthropic, OpenAI, and open-source models directly in the chat composer.
• ⚡ Model Badges — Each completed message shows which model was used.
• GitHub PR Workflow — Pull requests are automatically created after agent turns that change files.
• File Explorer — Browse your project's file tree, open files, and navigate your codebase
• Git Panel — View changed files, commit, push, and pull without leaving the IDE
• Project Selector — Switch between projects instantly from the header dropdown
• Learning + Live Edit Modes — Optional visual modes for onboarding and transparent change review

AI Chat

The OuterBot Panel includes an AI chat tab built for reliable coding workflows. You can:

• Ask questions about your codebase
• Get code explanations and suggestions
• Generate new code or refactor existing code
• Debug errors with AI assistance
• Watch deterministic progress states: thinking, tool use, and apply phases

GitHub Integration in the IDE

When you open a GitHub-linked project in the OuterBot Workspace:

1. The repository is cloned to the server automatically
2. The file tree loads from your actual repo files
3. You edit files in the Monaco editor
4. Use the Git Panel tab to commit and push changes back to GitHub

You can also create new GitHub repositories directly from the project selector dropdown in the IDE header.

Mobile Chat Pro

Pro members can chat with the AI from any phone or tablet — no app install required. Just open outer.bot/account in your mobile browser and tap Chat.

Features

• Guardian context pre-loaded — The living briefing from your VS Code project is automatically synced to the server and injected into every mobile chat session. The AI knows your project before you type the first message.
• Project switcher — Pick any of your OuterBot projects from the dropdown in the chat header. Context updates instantly.
• Persistent history — Conversation history is saved in your browser. Close the chat, come back later — it's still there (up to 24 hours).
• Session resume — If the AI server is still running your session, the conversation thread resumes where you left off.
• Full-screen overlay — Chat opens as a full-viewport panel so there's no wasted space on small screens.

How to use

1. Open outer.bot/account on your phone and sign in.
2. Tap Chat in the account menu — the chat modal opens immediately.
3. Select your project from the dropdown at the top of the chat.
4. Start chatting. The AI has your Guardian briefing already.

AI Credits & Models

OuterBot includes AI credits on every plan. No API key setup required — just sign up and start chatting.

Community — 10 Messages/Day

Community members get 10 AI messages per day included at no cost. Uses Claude Haiku via OuterBot's managed platform key. Resets at midnight UTC. No API key or credit card required.

Pro — Unlimited Credits at Cost

Pro members get unlimited AI credits charged at exactly what we pay — zero markup, ever. Credits never expire. All models available: Claude Sonnet/Opus (Anthropic), GPT-4o (OpenAI), and open source models (Llama, Mistral, and more via Groq).

Bring Your Own Key (Pro, Optional)

Pro members can optionally add their own Anthropic or OpenAI API key. When your own key is set, AI calls use it directly and don't consume OuterBot credits.

1. Go to your OuterBot Account Settings
2. Under AI Settings, paste your API key and choose your preferred model
3. Click Save — your key is encrypted with AES-256-CBC before storage

GitHub Connection

Connect your GitHub account to import repositories and push code.

Connecting GitHub

1. Go to Account Settings
2. In the "GitHub Integration" section, click "Connect GitHub"
3. Authorize OuterBot on GitHub (scopes: repo, read:user)
4. You'll be redirected back with your GitHub username shown

What You Can Do

• Import repos — Select from your GitHub repositories to add as OuterBot projects
• Create repos — Create new public or private repos directly from OuterBot
• Clone & edit — Open projects in the OuterBot Workspace to browse and edit files
• Commit & push — Save your work back to GitHub from the Git Panel

Project Management

Your account dashboard at outer.bot/account shows all your projects with health scores, technology tags, and quick actions.

• Import from GitHub — Import existing repos as projects
• Create new — Create a fresh GitHub repository
• Open in IDE — Launch any project in the OuterBot Workspace
• Sync from CLI/VS Code — Projects created locally sync to your dashboard automatically

AI Proxy Setup

Your personal AI proxy URL routes your IDE's requests through OuterBot. Context is injected automatically on every turn.

Claude Code

Paste this prompt directly into Claude Code — it will configure settings.json itself:

Please add OuterBot's proxy to my Claude Code settings. Add "env": { "ANTHROPIC_BASE_URL": "https://api.outer.bot/v2/YOUR_TOKEN/" } to my ~/.claude/settings.json, merging with any existing content.

Cursor

Settings → Models → API Base URL → paste your proxy URL.

Windsurf

Settings → AI → Custom API endpoint → paste your proxy URL.

Any OpenAI-compatible SDK

import openai
client = openai.OpenAI(
    base_url="https://api.outer.bot/v2/YOUR_TOKEN/",
    api_key="your-provider-key"
)

Git Proxy

Every push to git.outer.bot updates your project briefing automatically — what files changed, what commits say, what's new since the last session.

For new projects

Create a project in the OuterBot Workspace. The git remote is configured automatically — no terminal commands, no GitHub account required.

For existing repos

git remote add outerbot https://git.outer.bot/YOUR_USERNAME/YOUR_PROJECT.git
git push outerbot main

Your git remote URL is shown on the setup page after signing in.

CLI Installation

The OuterBot CLI provides project analysis, session tracking, and conversation memory from the command line.

npm install -g outerbot

Initialize a Project

cd your-project
outerbot init

Account Login

outerbot login
# Enter your email and password

CLI Commands

Project Management

outerbot init                    # Initialize project
outerbot status                  # Show project health & metrics
outerbot features                # List discovered features
outerbot suggest                 # Get AI improvement suggestions
outerbot analyze <file>          # Analyze a specific file

Account

outerbot login                   # Sign in to your account
outerbot sync                    # Sync project to dashboard

Conversation Memory

OuterBot captures and remembers coding conversations across all projects. Never lose track of how you built something.

How It Works

• Automatic capture — Hooks record conversations in real-time
• AI summarization — Progressive summarization reduces storage while preserving context
• Cross-project search — Find features built months ago in any project
• Context export — Load full context into new chat sessions

CLI Commands

outerbot memory search "query"   # Search across all projects
outerbot memory recent           # View recent conversations
outerbot memory export "topic"   # Export context for loading

Chat Shortcuts

/memory-search "query"           # Search conversations
/memory-recent                   # View recent work
/memory-record                   # Record current conversation
/session-start                   # Start session tracking
/session-record                  # Record session work

Session Tracking

Track your coding sessions to maintain continuity across work periods.

outerbot session start           # Start a new session
outerbot session record          # Record what you're working on
outerbot session history         # View past sessions
outerbot session end             # End and save the session

Sessions capture what you worked on, decisions made, and files changed — so future AI conversations can pick up exactly where you left off.