{"id":46573823,"url":"https://github.com/websitebutlers/codefire-app","last_synced_at":"2026-05-09T00:08:15.691Z","repository":{"id":341755529,"uuid":"1163660718","full_name":"websitebutlers/codefire-app","owner":"websitebutlers","description":"CodeFire gives AI coding tools persistent memory, task tracking, and project intelligence. A desktop companion for the AI-native workflow.","archived":false,"fork":false,"pushed_at":"2026-03-07T07:45:06.000Z","size":12415,"stargazers_count":117,"open_issues_count":0,"forks_count":15,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-07T14:57:48.047Z","etag":null,"topics":["claude","claudecode","context-engineering","context-engineering-framework","mcp"],"latest_commit_sha":null,"homepage":"https://codefire.app/","language":"Swift","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/websitebutlers.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-02-22T00:20:05.000Z","updated_at":"2026-03-07T07:04:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/websitebutlers/codefire-app","commit_stats":null,"previous_names":["websitebutlers/codefire-app"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/websitebutlers/codefire-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/websitebutlers%2Fcodefire-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/websitebutlers%2Fcodefire-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/websitebutlers%2Fcodefire-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/websitebutlers%2Fcodefire-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/websitebutlers","download_url":"https://codeload.github.com/websitebutlers/codefire-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/websitebutlers%2Fcodefire-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30324186,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T01:36:58.598Z","status":"online","status_checked_at":"2026-03-10T02:00:06.579Z","response_time":106,"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":["claude","claudecode","context-engineering","context-engineering-framework","mcp"],"created_at":"2026-03-07T09:20:08.297Z","updated_at":"2026-05-09T00:08:15.683Z","avatar_url":"https://github.com/websitebutlers.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/codefire-logo.png\" alt=\"CodeFire\" width=\"128\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eCodeFire\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eA local-first project wiki and persistent memory layer for AI coding agents\u003c/strong\u003e\u003cbr\u003e\n  Give Claude Code, Gemini CLI, Codex CLI, and OpenCode durable project context they can actually use\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/websitebutlers/codefire-app/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/badge/download-macOS-orange?style=flat-square\" alt=\"Download macOS\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/websitebutlers/codefire-app/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/badge/download-Windows-blue?style=flat-square\" alt=\"Download Windows\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/websitebutlers/codefire-app/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/badge/download-Linux-green?style=flat-square\" alt=\"Download Linux\"\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-lightgrey?style=flat-square\" alt=\"MIT License\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://codefire.app\"\u003eWebsite\u003c/a\u003e · \u003ca href=\"https://codefire.app/getting-started\"\u003eGetting Started\u003c/a\u003e · \u003ca href=\"docs/wiki.md\"\u003eWiki Memory\u003c/a\u003e · \u003ca href=\"docs/electron-wiki-parity.md\"\u003eElectron Parity\u003c/a\u003e · \u003ca href=\"https://discord.gg/cMtjR83D\"\u003eDiscord\u003c/a\u003e · \u003ca href=\"https://github.com/websitebutlers/codefire-app/discussions\"\u003eCommunity\u003c/a\u003e · \u003ca href=\"https://github.com/websitebutlers/codefire-app/releases/latest\"\u003eDownload\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## What is CodeFire?\n\nYour AI coding agent forgets everything between sessions. CodeFire fixes that.\n\nCodeFire gives every project a durable, local-first wiki for the things agents usually lose: architecture notes, schema explanations, runbooks, decisions, roadmaps, and glossaries. The wiki is markdown-native, initializes itself from your repo, supports `[[Wiki Links]]`, backlinks, page metadata, and cloud sync, and is exposed directly to agents through MCP so curated project knowledge can beat random grep results.\n\nAround that wiki, CodeFire auto-discovers your projects, tracks tasks and sessions, monitors live coding activity, and exposes project data back to your AI via MCP — creating a persistent memory layer where your agent knows what you were working on, what decisions were made, and what's left to do.\n\n### Wiki Memory\n\n- **One-click project wiki initialization** *(Swift)* — Seed architecture, schema, runbook, roadmap, and glossary pages from your current repo, then edit them as living project memory.\n- **Agent-readable curated context** *(Swift)* — Agents can create, update, search, read, list, and suggest wiki pages through MCP. `context_search` returns `wiki_results`, and RAG context includes relevant curated wiki pages before raw code snippets.\n- **Markdown links and backlinks** *(Swift)* — Use `[[Page Title]]` links to connect decisions, files, systems, and tasks; CodeFire tracks backlinks so related knowledge stays navigable.\n- **Metadata and sync hardening** *(Swift, new in v1.11.0)* — Wiki pages carry status, source, verification, related files, attribution, title uniqueness, soft-delete tombstones, and incremental cloud pull state for safer team sync.\n- **Local-first by default** — Wiki data lives in the same local SQLite database as tasks, notes, and sessions. Cloud sync is optional for teams.\n\nTwo platform implementations share the same SQLite database schema and MCP protocol:\n\n| Platform | Technology | Status |\n|----------|-----------|--------|\n| **macOS (Apple Silicon)** | Swift / SwiftUI | Beta — primary platform |\n| **Windows (x64)** | Electron / React / TypeScript | Early Alpha |\n| **Linux (x64)** | Electron / React / TypeScript | Early Alpha |\n| **macOS (Intel)** | Electron / React / TypeScript | Early Alpha |\n\n### Features\n\n- **Persistent memory** — Tasks, notes, wiki pages, and session context that survive across CLI sessions\n- **Project wiki** *(Swift, new in v1.11.0)* — Local-first markdown wiki for roadmaps, architecture, schema explanations, runbooks, decisions, and glossaries, with one-click initialization, `[[Wiki Links]]`, backlinks, page metadata, title uniqueness, and team cloud sync hardening\n- **Wiki-aware MCP context** *(Swift)* — Agents can create, update, search, read, list, and suggest wiki pages. `context_search` returns `wiki_results`, and RAG context includes relevant curated wiki pages before raw code snippets\n- **Task tracking** — Drag-and-drop Kanban board with priorities, labels, and task notes\n- **Live session monitoring** — Real-time token usage, cost tracking, and tool call stats\n- **Semantic code search** — Vector + keyword hybrid search across your indexed codebase\n- **Project workspace** *(Swift)* — Icon-first project header for terminal, open-in-editor, index status, filesystem/profile, MCP status, and sessions access without crowding the tab bar\n- **Multi-tab file editor** — Browse and edit project files in tabs, with syntax highlighting, line numbers, Cmd+F find, unsaved-change protection, and a right-click context menu to turn any selection into a task, note, or terminal command\n- **Rendered markdown** — Notes and Claude Code memory files render as styled markdown (tables, headings, code blocks) with a one-click Edit/Preview toggle\n- **Claude Code memory editor** — Edit the memory files Claude Code auto-loads every session, straight from the app\n- **Built-in terminal** — Tabbed terminal sessions alongside your project views, with show/hide toggle\n- **CLI orchestration** *(Swift, new in v1.9.0)* — One agent can spawn a complementary CLI in a new terminal tab and feed it a prompt — e.g. Claude Code asking Codex to investigate something — without you copy-pasting between terminals\n- **Agent handoffs** *(Swift, new in v1.9.0)* — Structured cross-CLI task handoffs: the sender creates a labeled task with the prompt, the receiving agent finds it in its inbox, reports progress through task notes, and closes the loop with a result note. Hidden from your Kanban by default behind a toolbar toggle so the chatter doesn't crowd user-tracked work\n- **Session-aware context engine** *(Swift, new in v1.10.0)* — When a Claude Code or Codex session starts in a tracked project, CodeFire detects it and runs an incremental verify pass that re-chunks only files that drifted since last index. An hourly scheduler does a full rebuild for any project past the configurable staleness threshold (default 7 days)\n- **Freshness contract on context_search** *(Swift, new in v1.10.0)* — `context_search` never blocks. When the index is stale, results return immediately with a `freshness` object indicating drift, and a background refresh is auto-enqueued so the next call sees fresh data\n- **Explicit context_search rule for agents** *(Swift, new in v1.10.0)* — MCP `serverInfo.instructions` ships a two-rule guidance block telling agents to prefer `context_search` for code exploration. Same rule is also written into per-project `CLAUDE.md` / `AGENTS.md` when a CLI is enabled\n- **Browser automation** — 40+ MCP tools for navigating, clicking, typing, screenshotting (Electron)\n- **Git integration** — Commits, staged changes, diffs, and branch management\n- **AI chat** — Ask questions about your codebase with RAG-powered context\n- **Image generation** — Text-to-image via OpenRouter (Gemini, DALL-E, etc.)\n- **Notes \u0026 briefings** — Pin lightweight observations, capture gotchas, get AI-generated daily briefings\n- **Gmail integration** — Sync emails into tasks with whitelist rules\n- **MCP server** — 79 tools exposing project data, wiki memory, browser automation, git, terminal orchestration, and context search to any AI coding CLI\n- **Universal compatibility** — Works with Claude Code, Gemini CLI, Codex CLI, and OpenCode\n\nFor a deeper explanation of the wiki, metadata model, MCP tools, and context-drift guardrails, see [CodeFire Wiki](docs/wiki.md). For the Windows/Linux parity roadmap, see [Electron Wiki Parity Handoff](docs/electron-wiki-parity.md).\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/screenshot-01.png\" alt=\"CodeFire — Planner view with Kanban board, task tracking, and project intelligence\" width=\"100%\"\u003e\n\u003c/p\u003e\n\n## Download\n\n| Platform | Download | Notes |\n|----------|----------|-------|\n| **macOS (Apple Silicon)** | [CodeFire-macOS.zip](https://github.com/websitebutlers/codefire-app/releases/download/v1.11.0/CodeFire-macOS.zip) | Native Swift app. Unzip and drag to Applications. |\n| **macOS (Electron alpha DMG)** | [CodeFire-1.10.0-arm64.dmg](https://github.com/websitebutlers/codefire-app/releases/download/v1.10.0/CodeFire-1.10.0-arm64.dmg) | Current Electron macOS build from v1.10.0. |\n| **macOS (Electron alpha zip)** | [CodeFire-1.10.0-arm64-mac.zip](https://github.com/websitebutlers/codefire-app/releases/download/v1.10.0/CodeFire-1.10.0-arm64-mac.zip) | Current Electron macOS zip from v1.10.0. |\n| **Windows** | [CodeFire.Setup.1.10.0.exe](https://github.com/websitebutlers/codefire-app/releases/download/v1.11.0/CodeFire.Setup.1.10.0.exe) | NSIS installer. Windows 10+ required. |\n| **Linux AppImage** | [CodeFire-1.10.0.AppImage](https://github.com/websitebutlers/codefire-app/releases/download/v1.11.0/CodeFire-1.10.0.AppImage) | Portable Linux build. |\n| **Linux deb** | [codefire-electron_1.10.0_amd64.deb](https://github.com/websitebutlers/codefire-app/releases/download/v1.11.0/codefire-electron_1.10.0_amd64.deb) | Debian/Ubuntu package. |\n\n\u003e For detailed setup instructions including API key configuration, see the **[Getting Started guide](https://codefire.app/getting-started)**.\n\n## Quick Start\n\n### 1. Install \u0026 Open\n\nDownload for your platform above, install, and launch CodeFire.\n\n### 2. Add Your OpenRouter API Key\n\nOpen Settings and go to the **Engine** tab (Electron) or **CodeFire Engine** tab (Swift). Paste your [OpenRouter API key](https://openrouter.ai/keys). This powers AI chat, semantic code search, and image generation.\n\n### 3. Connect Your CLI\n\nThe fastest way is the one-click install — visit [codefire.app/getting-started](https://codefire.app/getting-started) and click the button for your CLI.\n\nOr configure manually:\n\n```bash\n# Claude Code — macOS (Swift)\nclaude mcp add codefire ~/Library/Application\\ Support/CodeFire/bin/CodeFireMCP\n\n# Claude Code — Linux (AppImage, auto-synced on first launch)\nclaude mcp add codefire node ~/.local/share/CodeFire/mcp-server/server.js\n\n# Claude Code — Windows\nclaude mcp add codefire node \"%APPDATA%\\CodeFire\\resources\\mcp-server\\server.js\"\n```\n\n\u003cdetails\u003e\n\u003csummary\u003eOther CLI tools\u003c/summary\u003e\n\n**Gemini CLI** — `~/.gemini/settings.json`:\n```json\n{\n  \"mcpServers\": {\n    \"codefire\": {\n      \"command\": \"~/Library/Application Support/CodeFire/bin/CodeFireMCP\",\n      \"args\": []\n    }\n  }\n}\n```\n\n**Codex CLI** — `~/.codex/config.toml`:\n```toml\n[mcp_servers.codefire]\ncommand = \"~/Library/Application Support/CodeFire/bin/CodeFireMCP\"\nargs = []\n```\n\n**OpenCode** — `opencode.json` (project root):\n```json\n{\n  \"mcpServers\": {\n    \"codefire\": {\n      \"type\": \"local\",\n      \"command\": [\"~/Library/Application Support/CodeFire/bin/CodeFireMCP\"]\n    }\n  }\n}\n```\n\n\u003e Electron users: the MCP server path differs by platform. See the [setup guides](#4-add-system-instructions) for exact paths. Linux AppImage users: the MCP server is automatically synced to `~/.local/share/CodeFire/mcp-server/` on first launch.\n\n\u003c/details\u003e\n\n### 4. Add System Instructions\n\nFor the best experience, add CodeFire instructions to your CLI's system prompt file. This teaches your AI agent how to use CodeFire's tools effectively — session workflows, task tracking, notes, and more.\n\n| CLI | Setup Guide |\n|-----|-------------|\n| Claude Code | [codefire-claude-md-setup.md](docs/codefire-claude-md-setup.md) |\n| Gemini CLI | [codefire-gemini-setup.md](docs/codefire-gemini-setup.md) |\n| Codex CLI | [codefire-codex-setup.md](docs/codefire-codex-setup.md) |\n| OpenCode | [codefire-opencode-setup.md](docs/codefire-opencode-setup.md) |\n\nEach guide includes platform-specific MCP connection instructions (macOS, Windows, Linux) and copy-pasteable system instructions.\n\n### 5. Start Coding\n\nOpen a project folder in CodeFire, then start a CLI session. Your agent now has access to persistent memory, task tracking, browser automation, and code search — all through MCP.\n\n## MCP Server\n\nCodeFire's MCP server exposes **79 tools** to your AI coding agent:\n\n| Category | Tools | Examples |\n|----------|-------|---------|\n| **Tasks** | 6 | Create, update, list, and annotate tasks with notes |\n| **Notes** | 5 | Create, search, pin, and manage project notes |\n| **Wiki** *(Swift)* | 6 | Create, update, search, read, list, and suggest curated project wiki pages |\n| **Projects** | 2 | List projects, get current project context |\n| **Sessions** | 2 | List and search session history |\n| **Code Search** | 1 | Hybrid code search with freshness metadata and wiki results |\n| **Browser** | 40+ | Navigate, click, type, screenshot, eval JS, manage cookies |\n| **Terminal** *(Swift)* | 3 | Launch a CLI in a new tab, send text to a tab, list open tabs |\n| **Agent Handoffs** *(Swift)* | 3 | Create a cross-CLI handoff task, list your inbox, close with a result |\n| **Images** | 1 | List generated images |\n| **Clients** | 2 | List and create client groups |\n\n## Build from Source\n\n### macOS (Swift)\n\n```bash\ncd swift\nswift build -c release\n```\n\nSee [`swift/README.md`](swift/) for full build and signing instructions.\n\n### Windows / Linux / macOS Intel (Electron)\n\n```bash\ncd electron\nnpm install          # Install deps + rebuild native modules\nnpm run dev          # Start dev server + Electron\nnpm run build        # TypeScript compile + Vite build\nnpm test             # Run tests (Vitest)\nnpm run dist         # Package for current platform\nnpm run dist:win     # Windows installer (NSIS)\nnpm run dist:linux   # Linux packages (AppImage + deb)\nnpm run dist:mac     # macOS DMG + zip\n```\n\nSee [`electron/README.md`](electron/) for detailed architecture and development docs.\n\n## Repository Structure\n\n```\nswift/          macOS app (Swift/SwiftUI) — Beta\nelectron/       Windows/Linux/macOS Intel app (Electron/React/TypeScript) — Alpha\nlanding/        Marketing website (codefire.app)\nassets/         Shared screenshots and branding\nscripts/        Build and packaging scripts\nCLAUDE.md       Architecture docs for AI coding agents\nSECURITY.md     Security policy and vulnerability reporting\n```\n\n## Architecture\n\nBoth apps follow the same data model:\n\n- **SQLite database** at `~/Library/Application Support/CodeFire/codefire.db` (macOS), `~/.config/CodeFire/codefire.db` (Linux), or `%APPDATA%\\CodeFire\\codefire.db` (Windows)\n- **MCP server** communicates via stdio — no network listeners, fully local\n- **Project discovery** scans `~/.claude/projects/` for Claude Code session data\n- **Shared schema** — both Swift and Electron apps read/write the same database\n\n### Electron Architecture\n\nThe Electron app follows strict **main/preload/renderer** process separation:\n\n- **Main process** (`src/main/`) — Database, IPC handlers, services (Git, Terminal, Search, MCP)\n- **Preload** (`src/preload/`) — Typed bridge exposing `window.api` via contextBridge\n- **Renderer** (`src/renderer/`) — React 19 + Tailwind CSS 4 + Vite\n- **MCP server** (`src/mcp/`) — Standalone Node.js process spawned by CLI tools\n\nPath aliases: `@shared`, `@renderer`, `@main`\n\n## Contributing\n\nWe're actively looking for contributors, especially for the Electron app on Windows and Linux.\n\n- **[Getting Started guide](https://codefire.app/getting-started)** — Set up the app\n- **[Testers Wanted](https://github.com/websitebutlers/codefire-app/discussions/48)** — Testing guide with platform-specific instructions\n- **[Developer Wishlist](https://github.com/websitebutlers/codefire-app/discussions/49)** — Areas where we need help (search engine, browser automation, testing, MCP)\n- **[Community Guidelines](https://github.com/websitebutlers/codefire-app/discussions/47)** — How to get involved\n- **[CONTRIBUTING.md](CONTRIBUTING.md)** — Code style, branch naming, and PR guidelines\n- **[SECURITY.md](SECURITY.md)** — Vulnerability reporting\n\n### Priority Contribution Areas\n\n1. **Semantic search improvements** — Local embedding fallback, reranking, better chunking\n2. **Browser automation** — Network capture, session persistence, Web Vitals\n3. **Testing** — Swift unit tests, MCP protocol tests, E2E browser tests, CI matrix builds\n4. **Cross-platform parity** — Port features between Swift and Electron\n5. **MCP server extensions** — Git operations, custom tool plugins, metrics\n\n## Requirements\n\n- **macOS (Swift):** macOS 14.0 (Sonoma) or later, Apple Silicon\n- **Electron:** Windows 10+, Ubuntu 20.04+, or macOS 10.15+ (Intel or Apple Silicon via Rosetta)\n- **OpenRouter API key** for AI-powered features ([get one here](https://openrouter.ai/keys))\n- An AI coding CLI: [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [Codex CLI](https://github.com/openai/codex), or [OpenCode](https://github.com/sst/opencode)\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebsitebutlers%2Fcodefire-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwebsitebutlers%2Fcodefire-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebsitebutlers%2Fcodefire-app/lists"}