Skip to content

stark-ai-de/agent-skills / plugins/stark-ai-developer/skills/karakeep-knowledge

karakeep-knowledge

Unverified

Set up or use a local persistent Karakeep knowledge collection through its official MCP server. Use when configuring Karakeep for coding agents, checking an existing connection, checking project readiness, saving factual session reports, synchronizing approved canonical documents and separate drafts, maintaining approved source-backed aggregates, curating lists and tags, or consulting saved web sources for development work.

references/cli.md

View on GitHub
# Official CLI reads

Use this optional route when the official CLI is already available and reads are
authorized. It does not replace the [reconciliation helper](helper.md).

## Identity and account first

1. Inspect `type -a karakeep` and `command -v karakeep`. A local command with that
   name may be a service/Compose wrapper. Check its owner/package, version and help
   before using bookmark commands; do not install or replace it implicitly.
2. The inspected [v0.33.2 CLI source](https://github.com/karakeep-app/karakeep/tree/v0.33.2/apps/cli)
   declares `@karakeep/cli` version **0.33.0**. Check `karakeep --version`,
   `karakeep --help` and relevant subcommand help on the actual executable. That
   source has no `karakeep skill`; use it only if installed help proves support.
3. Resolve the approved loopback HTTP(S) origin and private credential environment.
   The helper/MCP uses `KARAKEEP_API_ADDR`; the CLI uses `KARAKEEP_SERVER_ADDR`.
   Validate the origin against the existing connection policy before mapping it:

   ```sh
   export KARAKEEP_SERVER_ADDR="${KARAKEEP_API_ADDR:?approved origin is required}"
   karakeep --json whoami
   ```

   Keep `KARAKEEP_API_KEY` in the private host-provided environment. Never put keys
   in command arguments, print them or source an untrusted env file. An absent
   address must stop the workflow: the CLI's cloud default is not the local account.
   Compare the returned account identity with the private receipt/policy before
   reading collection contents. Named hosts such as `karakeep.localhost` are outside
   this skill's direct loopback-origin contract.

## Bounded search and content

After identity/help/account checks, the inspected commands are:

```sh
karakeep --json bookmarks search 'list:"Project references" rust' --limit 5 --search-mode fts
karakeep --json bookmarks get BOOKMARK_ID
karakeep --json bookmarks content BOOKMARK_ID --format markdown --max-chars 20000
karakeep --json bookmarks content BOOKMARK_ID --format markdown --max-chars 20000 --cursor RETURNED_CURSOR
```

Use a real selected ID and returned cursor; the placeholder list is not created by
these commands. Start with metadata and a small limit. Full-text search is the
default; semantic/hybrid search requires existing server support and authorization.
Do not broaden to `--all`, another account or collection-wide export on an empty hit.

For an ordinary answer, an identified excerpt may suffice. State its limits and
cite the original URL. For verified sync evidence, follow every cursor to completion,
check one consistent `contentVersion`, preserve the complete text and hash, and
inspect its substance. A later-page error, missing cursor, changed version, login
page or summary is not a verified original. The helper performs those complete
reads itself; CLI snippets do not replace its bound plan/apply evidence.

For a separately requested PDF/SingleFile repair, inspect the existing release's
official asset/import or SingleFile capabilities. Preserve the original object,
notes and provenance; choose non-overwriting handling (`ifExists: skip` where
supported). Report capture failure instead of automatically uploading archives,
installing a capture engine or bypassing access controls.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall