Sandbox
@ducan-ne/opencoder

Claude Code-style terminal assistant for AI SDK models

OpenCoder is an open source replacement for Claude Code with a terminal UI, built-in file and memory tools, and support for MCP. It works with any provider that the Vercel AI SDK supports, and you can add custom tools in one step.

388 stars42 forksTypeScriptUpdated 1y ago
Who it's for

Builders who want a terminal coding assistant they can run with Claude Code-like workflows.

What it delivers

You can use a local, configurable coding agent with file tools, memory, and MCP integrations instead of a fixed assistant.

What it does

AI SDK model support

Uses the Vercel AI SDK, so it can work with OpenAI, Anthropic, Google, and other supported providers.

Built-in coding tools

Includes read, write, edit, think, memory read and edit, planning, grep, and TypeScript diagnostics.

MCP support

Can load MCP tools such as Playwright and web search with a small config snippet.

Cross-platform shell

Runs on Windows, Linux, and macOS with Deno shell support.

Custom tools and UI

Supports adding custom tools in one step, including custom tool interfaces.

How to get it

  1. 1Try it out
    npx opencoder@latest
  2. 2Run
    bunx opencoder@latest
  3. 3Or try the beta channel
    npx opencoder@next

README

OpenCoder: the open source version of Claude Code

Try it out:

npx opencoder@latest
bunx opencoder@latest

Or try the beta channel:

npx opencoder@next

Overview

  • Complete Claude Code replacement with similar UI and UX
  • Built on top of the Vercel AI SDK. Fully compatible with the AI SDK model.
  • Supports any LLM providers that the AI SDK supports (OpenAI, Anthropic, Google, etc.)
  • Cross-platform shell: which means supports Windows, Linux, and MacOS.
  • High performance: 60 FPS UI rendering, powered by React concurrent rendering, React Compiler
  • Add custom tools to OpenCoder in 1 step (with custom UI)

Demo

Youtube clone

https://github.com/user-attachments/assets/67c52f00-7c54-404d-b1e2-244312f0094a

Features

1. Built on top of the Vercel AI SDK

OpenCoder is built on top of the Vercel AI SDK. It is fully compatible with the AI SDK model, any official or community model supported by the AI SDK will work with OpenCoder:

import { ollama } from 'ollama-ai-provider'; // read more: https://sdk.vercel.ai/providers/community-providers/ollama
import type { Config } from 'opencoder';

export default {
  model: ollama('qwq'),
} satisfies Config

2. MCP makes it easy

Integrate powerful MCP capabilities into your workflow in 1 step. OpenCoder provides ready-to-use MCP tools that can be implemented with just a few lines of code:

import { playwright } from 'opencoder/mcp';

export default {
  mcp: [playwright()],
} satisfies Config

More examples:

3. Cross-platform shell

OpenCoder has a cross-platform shell that supports Windows, Linux, and MacOS. Powered by Deno shell

Available tools

  • Read file
  • Write file
  • Edit file
  • Think
  • Memory edit
  • Memory read
  • Planning
  • Grep: powered by @vscode/ripgrep
  • Check diagnostics (currently only Typescript is supported)

Available MCP tools

  • Playwright
  • Web search

Roadmap

  • More commands (/checkpoint, /revert, /commit, /mcp, /cost)
  • Documentation
  • Add auto-import MCP tools from .vscode/mcp.json or .cursorrules/mcp.json
  • Proper release process (changeset + changelog)
  • Command history
  • Persistent chat history
  • Add more tests
  • Add more examples
  • Tool confirmation dialog
  • Prebuilt MCP tools (import { playwright } from "opencoder/mcp")
  • Add MCP support
  • Support custom tools

Contributions are welcome!

Files in the repo

Repository payload20 top-level entries
  • examples
  • public
  • scripts
  • src
  • test
  • .augment-guidelines
  • .cursorrules
  • .gitignore
  • .oxlintrc.json
  • bump.config.ts
  • bun.lock
  • coder.d.ts
  • internal-roadmap.md
  • LICENSE.md
  • package.json
  • README.md
  • research.md
  • tsconfig.json
  • vite.config.ts
  • vitest.config.ts

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More tools

JuliusBrussee/
caveman

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

105k
1 add
MemPalace/
mempalace

The best-benchmarked open-source AI memory system. And it's free.

59k
stablyai/
orca

Orca is the ADE for working with a fleet of parallel agents. Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.

66k

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

132k

Never stop coding. Free MIT AI gateway: one endpoint, 352 providers (150+ free), 1200+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 550+ contributors

64k
headroomlabs-ai/
headroom

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.

71k