A cross-platform desktop companion app providing a persistent memory layer and project management for AI coding agents
CodeFire is a cross-platform desktop companion app designed for AI coding agents, fundamentally solving the problem of context loss across multiple CLI sessions. The app builds a persistent memory layer via a local SQLite database, automatically discovering projects and tracking session history, task status, and architectural decisions. Its built-in MCP server exposes 63 tools via stdio, enabling agents like Claude Code, Gemini CLI, Codex CLI, and OpenCode to sense prior work progress upon each startup.
Core Capabilities#
- Persistent Memory: Tasks, notes, and session context persist across CLI sessions
- Claude Code Memory Editor: Directly edit Claude Code's auto-loaded memory files within the app
- Drag-and-Drop Task Board: Supports priority, tags, and task notes
- Semantic Code Search: Vector + keyword hybrid search across indexed codebases
- Multi-Tab File Editor: Syntax highlighting, line numbers, search, unsaved change protection; right-click to convert selections to tasks/notes/terminal commands
- Markdown Rendering: Notes and memory files rendered as styled Markdown with edit/preview toggle
- Built-in Terminal: Tabbed terminal sessions alongside project view
- Git Integration: Commit, stage changes, diff view, branch management
- Browser Automation: 40+ MCP tools for navigation, clicking, input, screenshots (Electron version)
- AI Chat: RAG-based codebase Q&A (requires OpenRouter API Key)
- Image Generation: Text-to-image via OpenRouter (Gemini, DALL-E, etc.)
- Gmail Integration: Sync emails as tasks via whitelist rules
- Notes & Briefings: Pin architectural decisions, record notes, AI-generated daily briefings
Dual Frontend Architecture#
The project adopts a dual-frontend architecture with Swift (macOS native) and Electron (cross-platform), sharing the same SQLite database schema for cross-platform data consistency.
- macOS Apple Silicon: Native Swift/SwiftUI implementation (Beta), requires macOS 14.0+
- Windows / Linux / macOS Intel: Electron/React 19/Tailwind CSS 4/Vite implementation (Early Alpha), requires Windows 10+, Ubuntu 20.04+, macOS 10.15+
The Electron architecture enforces strict main/preload/renderer process isolation. The MCP Server runs as an independent Node.js process launched on-demand by CLI tools. All MCP communication is performed locally over stdio with no network listening.
Installation & Quick Start#
- Download and install the platform-specific package, then launch CodeFire
- Configure OpenRouter API Key in Settings → Engine tab
- Visit the official getting started guide for one-click CLI connection, or manually run
claude mcp add codefire <path>to register the MCP server - Add system instructions per CLI configuration guide
- Open a project folder in CodeFire and start a CLI session
Unconfirmed Information#
- Discord community link not provided in README
- Supabase backend purpose unclear (possibly related to billing, Gmail integration, or user auth)
- Business model not explicitly stated
- v1.7.0 mentioned in docs but latest GitHub Release is v1.6.1