climemo

Project knowledge management for AI coding agents.

Every AI coding session generates decisions, patterns, and context. Without a system, that knowledge disappears the moment the session ends. Climemo syncs your project documentation to a shared knowledge base — so your team and your AI agents always have the full picture.

Works with Claude Code, Cursor, GitHub Copilot, Codex, Windsurf, Gemini CLI, Cline, Aider, and more.

Website: https://climemo.com

Install

macOS / Linux:

curl -fsSL https://climemo.com/install.sh | bash

Windows (PowerShell):

irm https://climemo.com/install.ps1 | iex

npx (no install needed):

npx climemo@latest init

Requires Node.js 18+. The shell installer will install Node.js automatically if not found.

Quick Start

# Initialize in your project (login + setup + sync in one step)
cd your-project
climemo init

This will:

1. Open your browser to log in (email or GitHub)
2. Detect your AI agent(s) and create instruction files (CLAUDE.md, .cursor/rules/, etc.)
3. Sync all local markdown docs to the Climemo server

That's it. Your project is now connected.

Commands

Core

| Command | Description | |---------|-------------| | climemo init | All-in-one setup: login, configure agent files, sync docs | | climemo sync | Bidirectional sync — local docs ↔ server | | climemo setup | Create/update agent instruction files |

AI-Powered

| Command | Description | |---------|-------------| | climemo ask "question" | Ask AI about your project docs (RAG-powered) | | climemo ask "question" --with-docs | Ask AI and include full related documents | | climemo search "keywords" | Full-text search across all project docs | | climemo compare | Compare document versions side by side |

Collaboration

| Command | Description | |---------|-------------| | climemo invite [email protected] | Invite a team member to the project | | climemo members | List project members | | climemo comments list | View comments on documents | | climemo comments add "comment" | Add a comment to a document |

Maintenance

| Command | Description | |---------|-------------| | climemo review | Check which docs are stale and need updating | | climemo review --prompt-only | Output an update prompt for your AI agent | | climemo hook install | Install a git post-commit hook (auto-sync after every commit) | | climemo versions | View document version history |

Auth & Config

| Command | Description | |---------|-------------| | climemo login | Authenticate via browser OAuth | | climemo logout | Remove stored credentials | | climemo whoami | Show current user info | | climemo config set <key> <value> | Set configuration values | | climemo projects | List all your projects |

How It Works

Your repo (.md files)          Climemo Server            Web Dashboard
        │                           │                         │
        ├── climemo sync ──────────►│◄──── team members ──────┤
        │   (push local changes)    │      (edit on web)      │
        │                           │                         │
        │◄── climemo sync ─────────┤      search, ask AI,    │
        │   (pull remote changes)   │      comment, review    │
        │                           │                         │
        ├── climemo ask ───────────►│                         │
        │   (vector search + LLM)   │                         │
        │◄── AI answer ────────────┤                         │

1. Sync — All .md files in your repo are synced bidirectionally. Local file structure is the source of truth for renames/deletes; content changes merge both ways.
2. Ask — Your docs are chunked, embedded, and stored as vectors. climemo ask runs a similarity search and generates an answer using an LLM.
3. Review — Detects which docs are outdated based on recent code changes and suggests updates.

Agent Integration

Climemo auto-detects which AI coding agents you use and creates the appropriate instruction files:

| Agent | File Created | |-------|-------------| | Claude Code | CLAUDE.md | | Cursor | .cursor/rules/climemo.mdc | | Windsurf | .windsurf/rules/climemo.md | | GitHub Copilot | .github/copilot-instructions.md | | Codex / Devin / Amp | AGENTS.md | | Gemini CLI | GEMINI.md | | Cline | .clinerules | | Aider | CONVENTIONS.md | | Roo Code | .roo/rules/climemo.md | | Amazon Q | .amazonq/rules/climemo.md | | JetBrains AI | .aiassistant/rules/climemo.md | | Zed | .rules |

These files teach your AI agent how to use Climemo — when to sync, how to search, and how to keep docs up to date.

To set up a specific agent manually:

climemo setup --agent cursor

CI/CD Usage

Use the --token flag for non-interactive environments:

# Generate a token
climemo token

# Use in CI
climemo sync --token $CLIMEMO_TOKEN

Auto-Sync with Git Hooks

Install a post-commit hook to sync docs automatically after every commit:

climemo hook install

This runs climemo sync silently after each git commit.

Team Sync

When you run climemo sync, it automatically detects repo collaborators (via GitHub CLI, GitLab CLI, or Bitbucket API) and sends them signup invitations. This can be disabled with --no-team.

Supported platforms:

• GitHub — requires gh CLI (gh auth login)
• GitLab — requires glab CLI or a personal access token
• Bitbucket — requires an app password or access token

Web Dashboard

Your synced documents are available at climemo.com with:

• Full-text search across all projects
• AI Q&A (ask questions about your docs)
• Document versioning and diff viewer
• Comments and highlights
• Mermaid diagram rendering
• Team collaboration and access control
• Meeting notes with real-time collaboration

Configuration

# Set GitLab token for team sync
climemo config set gitlabToken glpat-xxxx

# Set Bitbucket token
climemo config set bitbucketToken xxxx
climemo config set bitbucketUsername your-username

Config file location: ~/.climemo/config.json

Links

• Website: climemo.com
• Dashboard: climemo.com/dashboard
• Pricing: climemo.com/pricing

License

MIT