ob-1

ob-1 is an open-source terminal-based AI coding agent created by Overbrilliant. Designed for developer workflows in the shell, it orchestrates automated code generation, refactoring, debugging, and file inspection directly inside local project repositories. Under the hood, ob-1 is built on TypeScript and Bun, offering execution speed and support for model routing. In everyday development, developers interact with ob-1 through a CLI interface to inspect file structures, generate edits, and run commands. The agent includes an embedded routing mechanism to interface with various backend language models, including options for free model tiers and standard commercial LLM providers. What sets ob-1 apart is its integration with existing developer ecosystem configs, including compatibility with Claude Code configuration formats such as `.mcp.json` for Model Context Protocol (MCP) server definitions. It also distributes as compiled standalone binaries (via curl or Homebrew) alongside standard npm packages with automatic Bun runtime shims. Distributed under an open-source license on GitHub, ob-1 is free to use and inspect. Operating costs depend on the model provider configurations chosen by the developer.

Tags: cli, code assistant, coding agent, OpenSource, terminal

Visit ob-1

Key features

  • MCP Configuration Compatibility — Parses .mcp.json configs directly to load Model Context Protocol server tooling seamlessly. - Embedded Model Routing — Built-in model routing architecture supporting various provider endpoints and free-tier configurations. - Bun-Powered Performance — Implemented in TypeScript on Bun for fast runtime startup and execution. - Multiple Distribution Formats — Available via compiled standalone binaries (Homebrew/curl) and standard npm packages with Node fallback shims. - Local File System Integration — Inspects, edits, and verifies local codebase changes directly within the terminal workspace.

Use cases

Use Case: Automated Local Codebase Refactoring Developers can point ob-1 at a multi-file repository directory to perform code modernizations, rename dependencies, or apply structural architectural changes across multiple files without manual copy-pasting.

Use Case: Extending Capabilities via Model Context Protocol Teams utilizing custom internal tools or databases can configure .mcp.json server endpoints, enabling ob-1 to query specialized context and external APIs directly during terminal sessions.

Use Case: Rapid Terminal-Based Debugging A developer debugging test failures or broken builds can invoke ob-1 in their workspace to analyze stack traces, inspect relevant source files, and apply proposed fixes in real time.

Who it is for

ob-1 is designed for command-line-centric software developers and teams looking for an open-source, extensible terminal coding agent compatible with MCP tool servers and alternative LLM backends. It is less suitable for non-technical users or developers who strictly require GUI-integrated IDE extensions without terminal interaction.

Install guide

Installation Install ob-1 globally using npm or run directly using Bun: bash # Install via npm (requires Node.js; automatically leverages Bun if present) npm install -g ob-1 # Or run directly via Bun bunx ob-1

First Run Navigate to your repository and initialize ob-1. If you have an existing MCP configuration, ensure .mcp.json is present in your project root: bash cd /path/to/your/project ob-1 Configure your provider API keys or model endpoints when prompted or via your environment variables.

Example Session Execute an interactive query or task against your project: bash ob-1 "Inspect src/index.ts and add error handling for unhandled promise rejections"

Part of CLI Coding Agents

Categories: AI Coding Agents, Code Assistants, Developer Tools

Related CLI agents

  • Qwen Code — Qwen Code is an open-source terminal-based AI coding assistant maintained by the Qwen team (Alibaba Cloud / QwenLM). Built on…
  • coro-code — coro-code is an open-source, terminal-based AI coding assistant developed in Rust by Blushyes. Built around a compiled native architecture, it…
  • Groq Code CLI — Groq Code CLI is an open-source command-line coding assistant developed by the build-with-groq team. It integrates directly with Groq's high-speed…
  • VTCode — VTCode is an open-source terminal-based AI coding agent built in Rust by Vinh Nguyen (vinhnx). Engineered as a high-performance CLI…
  • Nanocoder — Nanocoder is an open-source terminal-based AI coding assistant developed by the Nano-Collective community. Designed for software developers who prefer working…
  • CodeWhale — CodeWhale is an open-source terminal-based AI coding agent developed in Rust by Hunter Bown. It provides an autonomous and semi-autonomous…
  • AI Tools
  • Categories
  • Industries
  • CLI Coding Agents
  • MCP Servers
  • MCP Categories