@llamassist/codekeep-setup
v1.2.1
Published
One-command setup for CodeKeep - persistent AI coding sessions that remember context
Readme
@llamassist/codekeep-setup
Persistent memory for AI coding assistants.
Every Claude session starts from zero. CodeKeep fixes that by remembering what you're working on, what decisions you made, and where you left off. Sessions pick up exactly where the last one ended.
Quick Install
npx @llamassist/codekeep-setup ck_YOUR_API_KEYGet your API key at codekeep.ai
What This Does
- Installs the MCP server - Downloads and configures the CodeKeep MCP server
- Configures Claude Code - Sets up the MCP configuration in
~/.claude.json - Sets up project - Creates
.codekeep.jsonin your project directory - Installs hooks - Adds session start/end hooks for automatic context loading
Usage
Basic Setup
npx @llamassist/codekeep-setup ck_abc123def456Link to Existing Project
If you created a project in the dashboard first:
npx @llamassist/codekeep-setup ck_abc123 --project-id proj_existing123Custom Project Directory
npx @llamassist/codekeep-setup ck_abc123 --project-dir /path/to/my-projectSkip Hooks
If you don't want the session hooks installed:
npx @llamassist/codekeep-setup ck_abc123 --skip-hooksAfter Installation
- Restart Claude Code to load the new configuration
- Start a new session - CodeKeep will load automatically
- View your dashboard at codekeep.ai
Quick Test
Ask Claude: "What did I work on last session?"
Files Created
~/.codekeep/mcp-server/- The MCP server~/.codekeep/api-key- Your API key (for hooks)~/.claude.json- Updated with MCP configuration.codekeep.json- Project configuration.claude/settings.local.json- Project permissions.claude/hooks/- Session hooks (optional)
Troubleshooting
"MCP server not found"
Restart Claude Code after installation.
"Startup hook error"
The hooks couldn't find your API key. Re-run the installer or check ~/.codekeep/api-key exists.
Permission Issues
On Unix systems, ensure the hooks are executable:
chmod +x .claude/hooks/*.shMore Information
- Documentation: https://www.codekeep.ai/docs
- Dashboard: https://www.codekeep.ai
- Issues: https://github.com/rshambaugh/codekeep/issues
