About this project

OpenClaude is an open-source coding-agent command-line tool that supports a wide range of cloud and local model backends, including OpenAI-compatible APIs, Gemini, GitHub Models, Codex, Ollama, Fireworks AI, Cloudflare Workers AI, and others. It provides a single terminal-first workflow with prompts, tools, agents, MCP, slash commands, and streaming output. Key capabilities include: - Tool-driven coding workflows: Bash, file read/write/edit, grep, glob, agents, tasks, MCP, and slash commands. - Streaming responses with real-time token output and tool progress. - Multi-step tool calling with model calls, tool execution, and follow-up responses. - Image inputs (URL and base64) for vision-capable providers, including clipboard pasting and automatic resizing for API limits. - Guided provider setup and saved profiles via the /provider command. - Background sessions for running long non-interactive prompts detached from the current terminal, with commands to list, log, and kill sessions. - Conversation resume and fork by session ID. - Codebase intelligence (repo map) that builds a structural map of the repository ranked by PageRank importance. - Agent routing to different models for cost optimization, with configurable step limits. - Web search and fetch via DuckDuckGo (default for non-Anthropic models) or Firecrawl. - A headless gRPC server mode. - A bundled VS Code extension for launch integration and theme support. - A pixel-art companion feature that reacts to user input. OpenClaude requires Node.js >=22.0.0 and is installable via npm or an Arch Linux AUR package. It stores its own configuration under ~/.openclaude and does not read existing Claude Code configuration directories. The tool supports multiple providers but notes that behavior varies across them, with tool quality depending on the selected model.