{"id":49527179,"url":"https://github.com/genai-io/gen-code","last_synced_at":"2026-05-02T04:00:50.075Z","repository":{"id":258337042,"uuid":"852902752","full_name":"genai-io/gen-code","owner":"genai-io","description":"Open-source AI agent. Lives in your terminal.","archived":false,"fork":false,"pushed_at":"2026-05-01T06:08:14.000Z","size":7356,"stargazers_count":12,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-01T06:39:54.924Z","etag":null,"topics":["ai-agents","automation","claude-code","coding","gemini-cli","golang","opencode","provider-agnostic","teminal","workflow"],"latest_commit_sha":null,"homepage":"","language":"Go","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/genai-io.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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":"2024-09-05T16:16:25.000Z","updated_at":"2026-05-01T06:08:16.000Z","dependencies_parsed_at":"2026-03-15T07:02:25.258Z","dependency_job_id":"01dbe053-3d1c-46cb-8fcc-df1c3c9c093b","html_url":"https://github.com/genai-io/gen-code","commit_stats":{"total_commits":53,"total_committers":1,"mean_commits":53.0,"dds":0.0,"last_synced_commit":"0cbfdbfa83ac5de123e6626f2a68a19b7623bc9b"},"previous_names":["yanmxa/omni-agent","yanmxa/zengent","yanmxa/zen-agent","yanmxa/genpilot","yanmxa/chat-agent","yanmxa/gencode","genai-io/gen-code"],"tags_count":84,"template":false,"template_full_name":null,"purl":"pkg:github/genai-io/gen-code","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/genai-io%2Fgen-code","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/genai-io%2Fgen-code/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/genai-io%2Fgen-code/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/genai-io%2Fgen-code/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/genai-io","download_url":"https://codeload.github.com/genai-io/gen-code/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/genai-io%2Fgen-code/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32522252,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T01:12:54.858Z","status":"online","status_checked_at":"2026-05-02T02:00:05.923Z","response_time":132,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ai-agents","automation","claude-code","coding","gemini-cli","golang","opencode","provider-agnostic","teminal","workflow"],"created_at":"2026-05-02T04:00:33.890Z","updated_at":"2026-05-02T04:00:50.068Z","avatar_url":"https://github.com/genai-io.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gen Code\n\n\u003cp align=\"center\"\u003e\n  \u003ch1 align=\"center\"\u003e\u003c GEN ✦ /\u003e\u003c/h1\u003e\n  \u003cp align=\"center\"\u003e\n    \u003cstrong\u003eOpen-source AI coding assistant for the terminal\u003c/strong\u003e\n  \u003c/p\u003e\n  \u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/genai-io/gen-code/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/genai-io/gen-code?style=flat-square\" alt=\"Release\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://goreportcard.com/report/github.com/genai-io/gen-code\"\u003e\u003cimg src=\"https://goreportcard.com/badge/github.com/genai-io/gen-code?style=flat-square\" alt=\"Go Report Card\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://pkg.go.dev/github.com/genai-io/gen-code\"\u003e\u003cimg src=\"https://pkg.go.dev/badge/github.com/genai-io/gen-code.svg\" alt=\"Go Reference\"\u003e\u003c/a\u003e\n    \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\nOpen-source AI coding assistant for the terminal built with Go. Multi-provider LLM support, event-driven multi-agent orchestration, and full compatibility with [Claude Code](https://claude.ai/code) extensions, plugins, and project instructions.\n\n## Features\n\n- **Multi-provider** — Anthropic, OpenAI, Google, Moonshot, Alibaba, MiniMax — switch with `/model`\n- **Tools \u0026 MCP** — Built-in tools (Edit, Bash, Glob, Grep, WebSearch, etc.) + [MCP](https://modelcontextprotocol.io) integration\n- **Skills, Subagents \u0026 Plugins** — [Claude Code](https://claude.ai/code) compatible format, marketplace install\n- **Event-driven multi-agent** — Parallel agent execution with decoupled event-based coordination\n- **Hooks** — Lifecycle extensibility via shell, LLM, agent, or HTTP hooks\n- **Session** — Auto-persist, resume, fork, auto-compact\n- **Performance** — Minimal context injection, fast response, low token consumption\n- **Other** — Prompt prediction, configurable thinking effort, scheduled loops, permission control, etc.\n\n### Providers\n\n| Provider | Models | Environment Variables |\n|:---------|:-------|:----------------------|\n| **Anthropic** | Claude Opus 4.6, Sonnet 4.6 | `ANTHROPIC_API_KEY` or [Vertex AI](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/claude) |\n| **OpenAI** | GPT-5.2, GPT-5, o3, o4-mini, Codex | `OPENAI_API_KEY` |\n| **Google** | Gemini 3 Pro/Flash, 2.5 Pro/Flash | `GOOGLE_API_KEY` |\n| **Moonshot** | Kimi K2.5, K2 Thinking | `MOONSHOT_API_KEY` |\n| **Alibaba** | Qwen3.5 Plus, Qwen3 Max/Plus/Flash, QwQ, DeepSeek-V3/R1 | `DASHSCOPE_API_KEY` |\n| **MiniMax** | M2.7, M2.7 Highspeed, M2.5, M2.5 Highspeed, M2.1, M2.1 Highspeed, M2 | `MINIMAX_API_KEY` |\n\n\n## Installation\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/genai-io/gen-code/main/install.sh | bash\n```\n\nRe-run to upgrade. To uninstall:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/genai-io/gen-code/main/install.sh | bash -s uninstall\n```\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eOther methods\u003c/b\u003e\u003c/summary\u003e\n\n**Go Install**\n\n```bash\ngo install github.com/genai-io/gen-code/cmd/gen@latest\n```\n\n**Build from Source**\n\n```bash\ngit clone https://github.com/genai-io/gen-code.git\ncd gen-code\ngo build -o gen ./cmd/gen\nmkdir -p ~/.local/bin \u0026\u0026 mv gen ~/.local/bin/\n```\n\n\u003c/details\u003e\n\n## Usage\n\n```bash\n# Interactive mode\ngen\n\n# Non-interactive mode\ngen \"explain this function\"\ncat main.go | gen \"review this code\"\n\n# Resume previous session\ngen --continue        # Resume most recent\ngen --resume          # Select from list\n```\n\n### Quick Start\n\n1. Run `gen` to start interactive mode\n2. Use `/model` to connect a provider and select a model\n3. Start chatting!\n\n### Commands\n\n`/model` `/tools` `/skills` `/agents` `/mcp` `/plugin` `/compact` `/think` `/search` `/loop` `/resume` `/fork` `/clear` `/init` `/memory` — type `/help` for details.\n\nKeyboard: `Shift+Tab` toggle permission mode, `Ctrl+O` expand tool details, `Ctrl+C` cancel, `Ctrl+D` exit.\n\n## Configuration\n\nGen Code stores configuration in `~/.gen/`:\n\n```\n~/.gen/\n├── providers.json    # Provider connections and current model\n├── settings.json     # User settings (permissions, hooks, env)\n├── skills.json       # Skill states\n├── projects/         # Project-scoped session transcripts + indexes\n├── skills/           # Custom skill definitions\n├── agents/           # Custom agent definitions\n├── commands/         # Custom slash commands\n└── plugins/          # Installed plugins\n```\n\n### Project Instructions\n\nPlace a `GEN.md` (or `CLAUDE.md`) in your project root to provide project-specific instructions. These are automatically loaded into the system prompt. Project-level settings can also be placed in `.gen/settings.json`.\n\n### File-Based Configuration\n\nGenCode reads user-level files from `~/.gen/` and project-level files from `\u003cproject\u003e/.gen/`. Project files override user defaults for that workspace.\n\nCommon project files:\n\n```text\n.gen/settings.json      # Project permissions, hooks, disabled tools\n.gen/mcp.json           # Project MCP server definitions\n.gen/agents/*.md        # Project subagent definitions\n.gen/skills/*/SKILL.md  # Project skills\n.gen/commands/*.md      # Project slash commands\nGEN.md                  # Project instructions\n```\n\n## Benchmark: GenCode vs Claude Code\n\nCompared with [Claude Code](https://claude.ai/code) v2.1.112 on Apple Silicon, same model (`claude-sonnet-4-6`):\n\n| Metric | Gen Code | Claude Code | Advantage |\n|--------|---------|-------------|-----------|\n| Download size | 12 MB | 63 MB (+ Node.js 112 MB) | **5x smaller** |\n| Disk footprint | 38 MB | 175 MB | **4.6x smaller** |\n| Startup time | ~0.01s | ~0.20s | **20x faster** |\n| Startup memory | ~32 MB | ~189 MB | **5.8x less** |\n| Simple task | ~2.4s / 39 MB | ~10.4s / 286 MB | **4.3x faster, 7.3x less memory** |\n| Tool-use task | ~3.3s / 39 MB | ~26.0s / 285 MB | **7.9x faster, 7.2x less memory** |\n\nBoth tools have comparable features (hooks, skills, plugins, session, MCP, etc.). The performance gap comes from Go's native compilation, minimal architecture design, and lean prompt engineering — vs Node.js V8/JIT/GC runtime overhead.\n\nSee full details: [docs/benchmark-gencode-vs-claudecode.md](docs/benchmark-gencode-vs-claudecode.md)\n\n## Related Projects\n\n- [Claude Code](https://claude.ai/code) — Anthropic's AI coding assistant\n- [Aider](https://github.com/paul-gauthier/aider) — AI pair programming in terminal\n- [Continue](https://github.com/continuedev/continue) — Open-source AI code assistant\n\n## Contributing\n\nContributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## License\n\nApache License 2.0 - see [LICENSE](LICENSE) for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgenai-io%2Fgen-code","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgenai-io%2Fgen-code","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgenai-io%2Fgen-code/lists"}