climemo

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:

• Open your browser to log in (email or GitHub)
• Detect your AI agent(s) and create instruction files (CLAUDE.md, .cursor/rules/, etc.)
• 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 [e-mail]	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 ────────────┤                         │

• 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.
• Ask — Your docs are chunked, embedded, and stored as vectors. climemo ask runs a similarity search and generates an answer using an LLM.
• 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