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/sources.md

View on GitHub
# Upstream contracts and baseline

Checked 2026-10-13. Recheck for new installations/upgrades; these are a tested-design
baseline, not an automatic update policy.

| Contract                                     | Primary source                                                                                                                                                               |
| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Official three-service Compose topology      | [Docker installation](https://docs.karakeep.app/installation/docker/) and [v0.33.2 Compose](https://github.com/karakeep-app/karakeep/blob/v0.33.2/docker/docker-compose.yml) |
| Current web release checked                  | [Karakeep v0.33.2](https://github.com/karakeep-app/karakeep/releases/tag/v0.33.2)                                                                                            |
| Official MCP tools, STDIO and credentials    | [MCP integration](https://docs.karakeep.app/integrations/mcp/)                                                                                                               |
| MCP package contract                         | [Official npm package](https://www.npmjs.com/package/@karakeep/mcp) and [upstream source](https://github.com/karakeep-app/karakeep/tree/main/apps/mcp)                       |
| Storage, archive and inference configuration | [Environment variables](https://docs.karakeep.app/configuration/environment-variables/)                                                                                      |
| Supported imports                            | [Import guide](https://docs.karakeep.app/using-karakeep/import/)                                                                                                             |
| Optional local inference                     | [AI provider guide](https://docs.karakeep.app/configuration/different-ai-providers/)                                                                                         |
| Current Codex MCP configuration              | [OpenAI MCP documentation](https://learn.chatgpt.com/docs/extend/mcp)                                                                                                        |

The bundled Compose template pins Karakeep `0.33.2`, Meilisearch `1.41.0` and the
official Karakeep Chromium image by digest. The capture-browser `release` tag is
qualified by its immutable digest. These pins were observed in a local Linux setup;
they are not a claim of validation on every architecture or Docker host. Inspect
upstream platform manifests before using an untested architecture.

The MCP baseline is the separately published `@karakeep/mcp@0.33.1`. Verify the
installed package, tools and runtime; the app's release number is not the npm version.
This skill ships original orchestration and guidance only. It does not vendor
upstream server code or binaries; upstream Karakeep packages retain their own license
(AGPL-3.0). The local private-file launcher communicates with the official process.

## Synchronization and curation contracts

Checked 2026-10-14 against upstream `v0.33.2` source (not a live mutation test):

- [Lists](https://github.com/karakeep-app/karakeep/blob/v0.33.2/docs/docs/04-using-karakeep/lists.md): manual/private/shared and saved-query smart lists; bookmarks can belong to multiple lists.
- [Tags](https://github.com/karakeep-app/karakeep/blob/v0.33.2/docs/docs/04-using-karakeep/tags.md) and [search qualifiers](https://github.com/karakeep-app/karakeep/blob/v0.33.2/docs/docs/04-using-karakeep/search-query-language.md): cross-cutting labels and filtered retrieval.
- [MCP list schemas](https://github.com/karakeep-app/karakeep/blob/v0.33.2/apps/mcp/src/lists.ts): manual create fields, query updates and stable-ID membership. Do not infer smart-list creation/conversion from a query update.
- [MCP bookmark schemas](https://github.com/karakeep-app/karakeep/blob/v0.33.2/apps/mcp/src/bookmarks.ts): link/text creation, metadata updates; no text-body update field in the checked MCP.
- [MCP tags](https://github.com/karakeep-app/karakeep/blob/v0.33.2/apps/mcp/src/tags.ts) and [rule schema](https://github.com/karakeep-app/karakeep/blob/v0.33.2/packages/shared/types/rules.ts): inspect release support and current write authority before use.

The pinned npm MCP version remains `0.33.1`; the source tag above describes the web
repository contract, not proof of identical installed package tools. Discover the
actual session's schemas. These historical checks did not establish live execution. The 0.3.0 helper adds
separate direct-use qualification; it does not add a scheduled trigger or performance benchmark.

## Hermes host adapter

The 0.4.0 [Hermes adapter](hermes.md#checked-upstream-contract) records the checked
upstream revision, native skill discovery and session auto-load contract. Host
configuration and real agent execution require their own qualification.

## Node helper API profile

Checked against Karakeep `v0.33.2` for the 0.3.0 helper:

- [Bookmark REST routes](https://github.com/karakeep-app/karakeep/blob/v0.33.2/packages/api/routes/bookmarks.ts): paginated inventory, exact `text` PATCH, readable content with versioned continuation, tags and memberships.
- [List REST routes](https://github.com/karakeep-app/karakeep/blob/v0.33.2/packages/api/routes/lists.ts) and [list schemas](https://github.com/karakeep-app/karakeep/blob/v0.33.2/packages/shared/types/lists.ts): private manual list validation and membership.
- [API key schema](https://github.com/karakeep-app/karakeep/blob/v0.33.2/packages/shared/types/apiKeys.ts) and [user routes](https://github.com/karakeep-app/karakeep/blob/v0.33.2/packages/api/routes/users.ts): scoped credentials and expected-account verification.
- [Codex skills](https://learn.chatgpt.com/docs/build-skills#where-codex-loads-local-skills) and [global guidance](https://learn.chatgpt.com/docs/agent-configuration/agents-md#how-codex-discovers-guidance): user-wide discovery and instruction loading, not an executable startup hook.

## Review corrections and optional CLI contract (2026-10-16)

- [v0.33.2 bookmark creation](https://github.com/karakeep-app/karakeep/blob/v0.33.2/packages/trpc/routers/bookmarks.ts): `import`/`rss` duplicates return before ordinary re-save field/archive/timestamp mutations; the helper uses `import`.
- [v0.33.2 CLI](https://github.com/karakeep-app/karakeep/tree/v0.33.2/apps/cli): package version 0.33.0, explicit `KARAKEEP_SERVER_ADDR`, `whoami`, bounded search and versioned content continuation. No `skill` command in that source; installed help remains decisive.
- [Git hook environment contract](https://git-scm.com/docs/githooks#_description): remove Git's repository-local selectors (`rev-parse --local-env-vars`) before inspecting another checkout; keep unrelated authentication environment.

These are inspected source contracts. They do not establish installed CLI identity,
live Hermes behavior, source quality or collection readiness for the 0.5.0 candidate.
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: 472kUpdated 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