# karakeep

A skill for Claude Code that manages bookmarks, notes, and files via the official CLI. It triggers when adding, searching, or organizing content in Karakeep.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 574 installs · ★ 30752 repo stars
- Author: karakeep-app
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/karakeep-app/karakeep/tree/HEAD/skills/SKILL.md
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/karakeep

## What it does

The skill connects an AI agent to the Karakeep bookmark manager. It enables saving links, uploading PDFs, creating text notes, and searching the database via CLI commands. The system supports tags, lists, favorites, and automatic page archiving.

A `karakeep` CLI installation is required. Before use, authenticate via `karakeep auth init` by providing the server address and API key. If no key is set, the CLI reads it from the configuration file or `KARAKEEP_API_KEY` and `KARAKEEP_SERVER_ADDR` environment variables.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add karakeep-app/karakeep --skill karakeep -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/skills/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/skills/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add karakeep-app/karakeep --skill karakeep -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/skills/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add karakeep-app/karakeep --skill karakeep -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/skills/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install karakeep-app/karakeep skills
```

2. **Manually: put the files in place**
- File: `.github/skills/skills/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add karakeep-app/karakeep --skill karakeep -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/karakeep-app/karakeep --path skills
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/skills/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add karakeep-app/karakeep --skill karakeep -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/karakeep-app/karakeep/tree/HEAD/skills/SKILL.md

## When to use it
- save a web link with metadata
- find a bookmark by tag or text
- upload a PDF as an asset
- organize links into lists

## Example prompts
- Add the link `https://example.com` to Karakeep with the tag `reading`
- Find all bookmarks in Karakeep tagged `#work` that have notes
- Upload `./paper.pdf` to Karakeep as a new asset

## Similar
- [MoonlyBox MoonLink](https://affpapa.org/en/nevibecode/mcp/moonlybox-moonlink.md) — MCP server
- [cubox](https://affpapa.org/en/nevibecode/skills/cubox.md) — skill · 1200 installs
- [fieldtheory-cli-bookmarks](https://affpapa.org/en/nevibecode/skills/fieldtheory-cli-bookmarks.md) — skill · 635 installs
- [cli-anything-siyuan](https://affpapa.org/en/nevibecode/skills/cli-anything-siyuan.md) — skill · 255 installs
- [Obsidian Automation](https://affpapa.org/en/nevibecode/skills/obsidian-automation.md) — skill · 5000 installs
- [daily](https://affpapa.org/en/nevibecode/skills/daily.md) — skill · ★ 101 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
