{"id":48889240,"url":"https://github.com/ask-sol/openagent","last_synced_at":"2026-04-25T10:01:41.087Z","repository":{"id":351692690,"uuid":"1212078961","full_name":"ask-sol/openagent","owner":"ask-sol","description":"Open-source agentic coding CLI for your terminal. Multi-provider (OpenAI, Anthropic, Gemini, Mistral, Groq, DeepSeek, xAI, Ollama, OpenRouter), token-efficient, with web search, MCP server  support, local session resume, and built-in Reddit/X posting.","archived":false,"fork":false,"pushed_at":"2026-04-24T08:05:35.000Z","size":620,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-24T10:16:23.499Z","etag":null,"topics":["agent","agentic-ai","ai-agent","ai-cli","byok","claude-code-alternative","claude-max","cli","coding-assistant","developer-tools","ink","llm","mcp","multi-provider","ollama","open-source","openrouter","terminal-ui","typescript"],"latest_commit_sha":null,"homepage":"https://openagent-build.solz-ask.workers.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ask-sol.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-16T03:24:46.000Z","updated_at":"2026-04-24T08:05:38.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ask-sol/openagent","commit_stats":null,"previous_names":["ask-sol/openagent"],"tags_count":39,"template":false,"template_full_name":null,"purl":"pkg:github/ask-sol/openagent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ask-sol%2Fopenagent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ask-sol%2Fopenagent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ask-sol%2Fopenagent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ask-sol%2Fopenagent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ask-sol","download_url":"https://codeload.github.com/ask-sol/openagent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ask-sol%2Fopenagent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32257755,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-25T09:15:33.318Z","status":"ssl_error","status_checked_at":"2026-04-25T09:15:31.997Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","agentic-ai","ai-agent","ai-cli","byok","claude-code-alternative","claude-max","cli","coding-assistant","developer-tools","ink","llm","mcp","multi-provider","ollama","open-source","openrouter","terminal-ui","typescript"],"created_at":"2026-04-16T07:01:03.151Z","updated_at":"2026-04-25T10:01:41.079Z","avatar_url":"https://github.com/ask-sol.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eOpenAgent\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eThe open-source Claude Code alternative that works with any AI provider.\u003c/strong\u003e\u003cbr\u003e\n  Use your existing Claude Max subscription, OpenRouter, GPT-5, Gemini, Ollama, or any of 12 providers.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/ask-sol/openagent/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/ask-sol/openagent?style=for-the-badge\u0026color=yellow\" alt=\"Stars\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/ask-sol/openagent/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/ask-sol/openagent?style=for-the-badge\u0026color=green\u0026label=version\" alt=\"Version\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/ask-sol/openagent/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/ask-sol/openagent?style=for-the-badge\u0026color=blue\" alt=\"License\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003c!-- stats-start --\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"GitHub stars\" src=\"https://img.shields.io/github/stars/ask-sol/openagent?style=for-the-badge\u0026color=yellow\u0026label=stars\" /\u003e\n  \u003cimg alt=\"Total clones\" src=\"https://img.shields.io/badge/clones-1%2C580-9b59b6?style=for-the-badge\" /\u003e\n  \u003cimg alt=\"Unique users\" src=\"https://img.shields.io/badge/unique%20users-545-ec4899?style=for-the-badge\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003csub\u003eTracking since 2026-04-19 • 1,580 clones and 471 unique users in the last 14 days • updated 2026-04-25\u003c/sub\u003e\u003c/p\u003e\n\u003c!-- stats-end --\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/demo.gif\" alt=\"OpenAgent Demo\" width=\"700\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#install\"\u003eInstall\u003c/a\u003e •\n  \u003ca href=\"#why-openagent\"\u003eWhy OpenAgent\u003c/a\u003e •\n  \u003ca href=\"#providers\"\u003eProviders\u003c/a\u003e •\n  \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e •\n  \u003ca href=\"#commands\"\u003eCommands\u003c/a\u003e •\n  \u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## Why OpenAgent?\n\n**Already paying for Claude Max?** OpenAgent lets you use your existing subscription directly — no separate API key, no extra cost. Just log in and code.\n\n**Want provider freedom?** Switch between GPT-5, Claude, Gemini, Grok, DeepSeek, or local models with one command. No lock-in.\n\n**Want something open?** OpenAgent is Apache 2.0 licensed. Fork it, extend it, self-host it.\n\n### OpenAgent vs Claude Code\n\n| | **OpenAgent** | **Claude Code** |\n|:---|:---|:---|\n| **Providers** | 12+ (OpenAI, Anthropic, Gemini, Groq, Mistral, DeepSeek, xAI, Bedrock, Alibaba, Ollama, OpenRouter) | Anthropic only |\n| **Use Max/Pro subscription** | ✅ No API key needed | ✅ Built-in |\n| **Run local models** | ✅ Ollama with auto-install \u0026 download | ❌ |\n| **Cost** | Free + bring your own key | $20/mo minimum |\n| **Syntax-highlighted diffs** | ✅ Full language-aware highlighting | ✅ |\n| **Terminal mode** | ✅ Ctrl+T for inline shell | ❌ |\n| **Web search** | ✅ Built-in | ❌ |\n| **Social media posting** | ✅ Reddit \u0026 X | ❌ |\n| **WhatsApp/Discord bridges** | ✅ | ❌ |\n| **Permission modes** | ✅ Standard, Cautious, Unrestricted | ✅ Auto accept edit, Plan mode, Bypass |\n| **Real-time cost tracking** | ✅ Live in status bar | ❌ No API cost tracking|\n| **Open source** | ✅ Apache 2.0 | Source-available |\n\n---\n\n## Install\n\n**macOS**\n```bash\nbrew install ask-sol/openagent/openagent\n```\n\n**Linux / WSL**\n```bash\ncurl -fsSL https://raw.githubusercontent.com/ask-sol/openagent/main/scripts/install-remote.sh | bash\n```\n\n**From source**\n```bash\ngit clone https://github.com/ask-sol/openagent.git \u0026\u0026 cd openagent \u0026\u0026 bash scripts/install-user.sh\n```\n\n**Update**\n```bash\nopenagent --upgrade\n```\n\nThen just run `openagent`. The setup wizard walks you through everything.\n\n\n---\n\n## Built by OpenAgent\n\nOne prompt was used to build this website for OpenAgent, made with Opus 4.7 (OpenAgent v0.1.30-20260418)\n\n```website\nhttps://openagent-build.solz-ask.workers.dev\n```\n\n---\n## Quick Start\n\n```bash\nopenagent              # Interactive setup on first run\nopenagent -u           # Unrestricted mode — no permission prompts\nopenagent -c           # Cautious mode — asks before every action\nopenagent -t           # Thinking mode\nopenagent --setup      # Re-run setup wizard\n```\n\n---\n\n## Providers\n\n| Provider | Type | What you get |\n|:---|:---|:---|\n| **Anthropic (Max Plan)** | 🔑 Subscription | **Use your existing Claude Max/Pro plan.** No API key. Claude Opus 4.7, Sonnet 4.6, Haiku 4.5 |\n| **OpenRouter** | ☁️ Cloud | **One key, every model.** GPT-5.4, Claude, Gemini, Llama, Mistral, DeepSeek, Grok + 100 more |\n| **OpenAI** | ☁️ Cloud | GPT-5.4, GPT-4.1, o3, o4-mini |\n| **Anthropic** | ☁️ Cloud | Claude Opus 4.7, Sonnet 4.6, Haiku 4.5 (API key) |\n| **Google Gemini** | ☁️ Cloud | Gemini 3.1 Pro, 3 Flash, 2.5 Pro/Flash |\n| **AWS Bedrock** | ☁️ Cloud | Claude, Llama, Mistral, Nova on AWS |\n| **Mistral** | ☁️ Cloud | Mistral Large 3, Small 4, Codestral |\n| **Groq** | ☁️ Cloud | Llama 4 Scout, Llama 3.3 70B, Qwen 3 32B |\n| **DeepSeek** | ☁️ Cloud | DeepSeek V3.2, R1 |\n| **xAI** | ☁️ Cloud | Grok 4.20 (2M context), Grok Code Fast |\n| **Alibaba Cloud** | ☁️ Cloud | Qwen 3 235B, Qwen Max, QwQ 32B |\n| **Ollama** | 💻 Local | Any model. Auto-installs Ollama, auto-downloads models, RAM/GPU guidance |\n\nSwitch anytime: `/model` opens a categorized picker (Cloud vs Local). API key asked only when needed.\n\n---\n\n## Features\n\n### 🤖 Agentic Coding\nRead, write, and edit files. Run shell commands. Search codebases by filename or content. Multi-step tasks execute autonomously with a live task checklist.\n\n### 🔐 Permission Modes\n- **Standard** — asks before file writes and commands\n- **Cautious** — asks before everything\n- **Unrestricted** — full auto (UI turns red as a warning)\n\nCycle with `Shift+Tab`. Set on launch with `-u` or `-c`.\n\n### 💰 Token Efficient\nConcise mode strips AI filler without cutting code quality. `CONTEXT.session` persists knowledge across sessions. `/compact` compresses conversation to free tokens. Real-time token counter in the status bar.\n\n### 🖥️ Terminal Mode\n`Ctrl+T` switches the input box to a direct shell. Run `git status`, `npm test`, anything — without the AI. `Ctrl+T` again to switch back.\n\n### 🔍 Web Search\nBuilt-in DuckDuckGo search. The AI automatically searches when it needs current information — no manual prompting needed.\n\n### 🎨 Syntax-Highlighted Diffs\nFile changes display with full syntax highlighting — keywords, strings, comments all colored by language. Line numbers, `+`/`-` markers, context lines.\n\n### 📱 Messaging Bridges\n`/whatsapp` and `/discord` let you receive commands from your phone or a Discord server. The AI processes them and responds.\n\n### 📢 Social Media\n`/setup-reddit` and `/setup-x` for posting directly from the terminal.\n\n### 💾 Session Resume\nAll sessions stored locally. `/resume` picks up where you left off. No cloud, no accounts — your data stays on your machine.\n\n### 🔌 MCP Servers\nConnect any MCP-compatible tool server via `~/.openagent/mcp_servers.json`.\n\n---\n\n## Commands\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e70+ built-in commands\u003c/strong\u003e (click to expand)\u003c/summary\u003e\n\n| Category | Commands |\n|:---|:---|\n| **General** | `/help` `/exit` `/version` `/doctor` `/upgrade` `/changelog` `/feedback` |\n| **Conversation** | `/clear` `/compact` `/copy` |\n| **Session** | `/resume` `/context` `/tokens` `/cost` `/export` `/rename` `/tag` `/memory` `/stats` |\n| **Git** | `/diff` `/status` `/branch` `/log` `/stash` `/commit` `/smartcommit` `/push` `/pull` `/pr` `/review` |\n| **Permissions** | `/permissions` `/mode` |\n| **Config** | `/provider` `/model` `/max-tokens` `/config` `/response-mode` `/setup` `/env` `/alias` |\n| **Tools** | `/tools` `/mcp` |\n| **Files** | `/files` `/pwd` `/find` `/grep` `/cat` `/size` |\n| **Shell** | `/run` `/npm` |\n| **Dev** | `/test` `/lint` `/build` `/autofix` `/project` `/scaffold` `/refactor` `/explain` `/security` `/perf` `/snippet` `/benchmark` `/deps` `/debug` |\n| **Workflow** | `/plan` `/undo` `/rewind` `/todo` |\n| **UI** | `/theme` `/vim` `/brief` `/keybindings` |\n| **Utility** | `/clipboard` `/image` `/time` `/calc` `/json` `/encode` `/decode` `/uuid` `/hash` `/regex` `/sql` `/diagram` `/translate` `/ip` `/port` `/processes` `/disk` `/open` `/weather` |\n| **Social** | `/setup-reddit` `/setup-x` `/reddit` `/tweet` |\n| **Bridges** | `/whatsapp` `/discord` |\n\n\u003c/details\u003e\n\n---\n\n## Keyboard Shortcuts\n\n| Key | Action |\n|:---|:---|\n| `Ctrl+T` | Toggle terminal mode |\n| `Ctrl+B` | Expand/collapse old messages |\n| `Shift+Tab` | Cycle permission mode |\n| `Esc` | Interrupt current task |\n| `Ctrl+C` | Exit |\n\n---\n\n## Contributing\n\nContributions are welcome. Check out the [issues](https://github.com/ask-sol/openagent/issues) or open a PR.\n\nIf you find OpenAgent useful, please consider giving it a ⭐ — it helps others discover the project.\n\n## License\n\nApache 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fask-sol%2Fopenagent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fask-sol%2Fopenagent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fask-sol%2Fopenagent/lists"}