{"id":49626730,"url":"https://github.com/prasenjeet-symon/ogcode","last_synced_at":"2026-05-30T13:00:47.819Z","repository":{"id":355609254,"uuid":"1226383350","full_name":"prasenjeet-symon/ogcode","owner":"prasenjeet-symon","description":"A web UI coding agent that handles the full development loop: understand your codebase, plan features collaboratively, spin up isolated branch agents, write the code, and ship PRs — all in parallel. Written in Go.","archived":false,"fork":false,"pushed_at":"2026-05-23T08:45:12.000Z","size":37476,"stargazers_count":118,"open_issues_count":1,"forks_count":9,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-23T10:37:51.717Z","etag":null,"topics":["ai","ai-agent","automation","code-generation","coding-assistant","developer-tools","go","golang","llm","pair-programming"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/prasenjeet-symon.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":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":"2026-05-01T10:24:31.000Z","updated_at":"2026-05-23T08:45:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/prasenjeet-symon/ogcode","commit_stats":null,"previous_names":["prasenjeet-symon/ogcode"],"tags_count":25,"template":false,"template_full_name":null,"purl":"pkg:github/prasenjeet-symon/ogcode","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prasenjeet-symon%2Fogcode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prasenjeet-symon%2Fogcode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prasenjeet-symon%2Fogcode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prasenjeet-symon%2Fogcode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prasenjeet-symon","download_url":"https://codeload.github.com/prasenjeet-symon/ogcode/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prasenjeet-symon%2Fogcode/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33692997,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"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","ai-agent","automation","code-generation","coding-assistant","developer-tools","go","golang","llm","pair-programming"],"created_at":"2026-05-05T08:01:13.011Z","updated_at":"2026-05-30T13:00:47.801Z","avatar_url":"https://github.com/prasenjeet-symon.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ogcode\n\n[![Discord](https://img.shields.io/discord/1373677337985056828?label=Discord\u0026logo=discord\u0026logoColor=white\u0026color=5865F2)](https://discord.gg/JQP9t8y2Zv)\n\n![Ogcode Demo](assets/ogcode_intro.gif)\n\nAn agentic coding assistant with a web UI, written in Go.\n\nOgcode acts as a pair programmer that actually codes with you. It doesn't just suggest snippets; it understands your entire codebase, plans complex features, and executes them by creating branches and PRs automatically. It can even run multiple tasks in parallel across different branches, allowing you to ship entire features in a fraction of the time. Whether you're hunting a bug or building a zero-to-one feature, Ogcode handles the heavy lifting so you can focus on the architecture.\n\nOgcode gives you two ways to work with AI on your codebase:\n\n- **Build Mode** — Chat directly with an AI agent that can read, write, edit, and execute code in your project.\n- **Plan Mode** — Collaboratively plan a feature or refactor with a read-only planning agent, then break the plan into tasks. Each task gets its own git branch and an isolated agent session. Completed tasks auto-create pull requests. Multiple tasks can run in parallel, drastically speeding up complex feature implementations.\n\n---\n\n## Roadmap\n\n- [ ] **Advanced Task Planning \u0026 Parallel Execution**: Enhanced plan decomposition, allowing users to manually or automatically assign coding agents to tasks, with full parallel execution support.\n- [ ] **AI Daily Standups**: Voice-enabled daily meetings where all agents assigned to a project can report progress and discuss their work. This includes natural voice interactions, project-specific memory, and the ability to take and remember human feedback.\n- [ ] **Ogland Integration**: A dedicated space within Ogcode to connect external services like Slack, Email, Jira, and more, enabling their use during the planning phase.\n- [ ] **Agentic Deployment**: Full end-to-end agentic deployment support for all major cloud providers, starting with AWS.\n\n---\n\n## Agentic Session Memory 🧠\n\n![Agentic Memory Demo](assets/agentic_memory.gif)\n\nOgcode's **Agentic Session Memory** revolutionizes how AI coding assistants handle context in long-running sessions. Instead of sending the entire conversation history to the LLM (which quickly becomes expensive and hits token limits), Ogcode intelligently extracts, stores, and retrieves only the relevant context needed for each query.\n\n### Key Benefits\n\n| Feature | Impact |\n|---------|--------|\n| **~70% Token Savings** | Drastically reduced API costs on long sessions |\n| **Infinite Context** | No practical limit on session length or codebase size |\n| **Higher Accuracy** | Only relevant memories are retrieved per query |\n\n### Enable Agentic Memory\n\n```bash\nexport OGCODE_AGENTIC_MEMORY_MODE=true\n```\n\n### Token Savings Example\n\n| Session Length | Traditional | With Agentic Memory | Savings |\n|----------------|-------------|---------------------|---------|\n| 50 messages | ~25K tokens | ~8K tokens | **68%** |\n| 200 messages | ~100K tokens | ~28K tokens | **72%** |\n| 1000 messages | ~500K tokens | ~120K tokens | **76%** |\n\n*Actual savings vary based on codebase complexity and conversation patterns.*\n\n---\n\n## Installation\n\n### macOS / Linux\n\n**Via Homebrew:**\n\n```bash\nbrew tap prasenjeet-symon/ogcode\nbrew install ogcode\n```\n\n**Via curl:**\n\n```bash\ncurl -fsSL http://ogcode.xyz/install.sh | sh\n```\n\nThe installer auto-detects your platform, downloads the latest release, and installs to `/usr/local/bin` (uses `sudo` if needed).\n\n### Windows\n\n```powershell\nirm http://ogcode.xyz/install.ps1 | iex\n```\n\nThis downloads the latest release, extracts it to `%LOCALAPPDATA%\\ogcode`, and adds it to your PATH automatically.\n\n**Via winget (after next release):**\n\n```powershell\nwinget install prasenjeet-symon.ogcode\n```\n\n**Manual install:**\n\n1. Go to the [releases page](https://github.com/prasenjeet-symon/ogcode/releases) and download `ogcode_Windows_x86_64.zip` (or `_arm64.zip` if you have an ARM device).\n2. Extract the zip file to a folder (e.g. `C:\\Tools\\ogcode`).\n3. Add that folder to your `Path` environment variable:\n   - Press `Win + S`, search for **Edit environment variables for your account**\n   - Under **User variables**, find `Path` and click **Edit**\n   - Click **New** and add the path to your ogcode folder (e.g. `C:\\Tools\\ogcode`)\n   - Click **OK** on all dialogs\n4. Open a new PowerShell or Command Prompt and run:\n\n```powershell\nogcode version\n```\n\n### Go Install\n\n```bash\ngo install github.com/prasenjeet-symon/ogcode@latest\n```\n\n### Docker\n\n```bash\ndocker run -p 8080:8080 -v $(pwd):/workspace -w /workspace ghcr.io/prasenjeet-symon/ogcode:latest\n```\n\n---\n\n## Configuration\n\nOgcode auto-detects available AI providers based on environment variables. No config files are required.\n\n### Required: AI Provider\n\nSet at least one API key (or use Ollama):\n\n| Variable | Provider |\n|----------|----------|\n| `ANTHROPIC_API_KEY` | Anthropic (Claude) |\n| `OPENAI_API_KEY` | OpenAI (GPT) |\n| `OPENROUTER_API_KEY` | OpenRouter |\n| `OLLAMA_API_KEY` | Ollama Cloud (see below) |\n| `OLLAMA_BASE_URL` | Ollama (local / cloud URL) |\n\n#### Ollama (local models)\n\nOgcode auto-detects Ollama on macOS/Linux if the binary is installed at a common path. On Windows, or if you have a non-standard install, set `OLLAMA_BASE_URL` explicitly.\n\n**Local setup (default):**\n\n```bash\n# macOS / Linux — auto-detected if ollama is installed\nollama serve\nogcode\n\n# Or be explicit on any OS:\nexport OLLAMA_BASE_URL=http://localhost:11434/v1\nogcode\n```\n\nOn Windows (PowerShell):\n\n```powershell\n$env:OLLAMA_BASE_URL = \"http://localhost:11434/v1\"\nogcode\n```\n\n**Remote or Ollama Cloud:**\n\n```bash\nexport OLLAMA_BASE_URL=https://api.ollama.com/v1   # or your custom endpoint\nexport OLLAMA_API_KEY=your-api-key                  # required for cloud / authenticated endpoints\nogcode\n```\n\nOn Windows (PowerShell):\n\n```powershell\n$env:OLLAMA_BASE_URL = \"https://api.ollama.com/v1\"\n$env:OLLAMA_API_KEY = \"your-api-key\"\nogcode\n```\n\n**Set a default model:**\n\n```bash\nexport OLLAMA_MODEL=codellama   # defaults to qwen3-coder-next if not set\n```\n\nAvailable models in the UI include: `qwen3`, `codellama`, `llama3.1`, `deepseek-coder-v2`, `mistral`, and others. Any model you have pulled in Ollama will work — just select it from the model dropdown in the web UI.\n\n### Optional: Agentic Memory\n\nTo give the agent long-term memory across sessions, set:\n\n```bash\nexport OGCODE_AGENTIC_MEMORY_MODE=true\n```\n\nThis connects to an MCP-compatible memory server (configure via `MCP_SERVER_*` env vars).\n\n### Optional: Custom Models\n\nYou can add custom models (e.g. fine-tuned endpoints) through the web UI at **Settings → Models**.\n\n---\n\n## Usage\n\n### Start in Build Mode (default)\n\n```bash\nogcode\n```\n\nOpens the web UI at `http://localhost:8080`. Chat with the agent, ask it to read files, write code, run commands, or search the codebase.\n\n### Start in Plan Mode\n\n```bash\nogcode plan\n```\n\nOpens the planning interface. Describe what you want to build. The planning agent will understand your codebase and discuss the approach with you. When you are satisfied, click **Lock Plan** — the agent breaks it into tasks with dependencies, effort, and complexity estimates.\n\n### Use a custom port\n\n```bash\nogcode -p 3000\nogcode plan -p 3000\n```\n\n### Check version\n\n```bash\nogcode version\n```\n\n---\n\n## The Plan Mode Workflow\n\n1. **Describe** — Open a new plan and describe your goal. The planning agent reads your codebase and helps refine the approach.\n2. **Lock** — When ready, lock the plan. The agent generates a structured task breakdown.\n3. **Review** — View tasks in the Kanban board. Each task has a title, description, effort (S/M/L/XL), complexity, and dependencies.\n4. **Execute** — Start tasks. Each one gets its own git branch and an isolated agent session. You can watch the agent work in real time.\n5. **Complete** — When a task finishes, the agent commits its changes and a pull request is automatically created. Ogcode manages dependencies between tasks and runs independent tasks in parallel.\n6. **Retry** — If a task fails, retry it. The stale branch is removed and the task starts fresh.\n\nPlans are archived as markdown files in `.ogcode/archives/` once all tasks are completed.\n\n---\n\n## Community\n\nJoin the Ogcode community on Discord for discussions, support, and updates:\n\n[![Join us on Discord](https://img.shields.io/discord/1373677337985056828?label=Join%20Discord\u0026logo=discord\u0026logoColor=white\u0026color=5865F2\u0026style=for-the-badge)](https://discord.gg/JQP9t8y2Zv)\n\n- Ask questions and get help\n- Share feedback and feature ideas\n- Stay up to date with releases and announcements\n\n---\n\n## License\n\nMIT License — see [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprasenjeet-symon%2Fogcode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprasenjeet-symon%2Fogcode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprasenjeet-symon%2Fogcode/lists"}