---

name: potpie description: "Operate Potpie's CLI, daemon, context graph, source bindings, auth integrations, and bundled agent skills." metadata: disco-role: operating disable-model-invocation: true license: Apache 2.0

Potpie

Use this repo skill when a task names Potpie or asks how to operate its CLI, daemon runtime, Context Graph memory, pot/source workspace boundaries, provider integrations, graph read/write surface, or bundled agent-skill installer.

Quick start

uv tool install potpie          # or: python -m pip install potpie
potpie --version
potpie --help
potpie daemon status

If you are working inside a live Potpie source checkout, the repo also provides make cli-install and make cli-status; those are convenience paths, not requirements for using this generated skill.

Route by task

Task surface	Read
Install, setup, status, doctor, daemon, backend, UI, telemetry	runtime
Pots, active workspace, repo defaults, registered sources	workspace-boundaries
Potpie login/logout, provider credentials, GitHub/GitLab/Linear/Jira/Confluence/GitBucket, ledger	auth-integrations
Resolve/search/read graph context, entity keys, neighborhoods, timeline, graph status, inspect/export	graph-read
Record/propose/commit/mutate graph state, import/repair, inbox, quality, bulk, nudge	graph-write
Install/update/status/remove Potpie's bundled agent skills	skills-management

Operating rules

• Diagnose runtime availability before retrying graph or skills commands. potpie daemon status is the safe first probe; many higher-level commands are daemon-dependent.
• Keep workspace identity explicit. Pot/source registration chooses the workspace boundary; it does not by itself scan or ingest data.
• Keep provider credentials separate from source bindings. A provider token does not automatically link a repo to a pot or populate the graph.
• Prefer read-before-write for graph tasks: resolve entity keys and scope, then use graph propose followed by graph commit for durable changes.
• Treat Event Ledger and managed/cloud command surfaces as limited unless the current runtime proves support.
• Do not use Potpie's own potpie skills install command to import this generated DisCo repo skill; that command manages Potpie's packaged agent bundle.

Bundled helpers

• scripts/potpie_smoke.sh — safe CLI help/version/daemon-status smoke check.
• scripts/typecheck_public_context_api.py — public API import smoke for context-core/context-engine.
• scripts/generate_agent_contract.py — installed-package graph/agent contract reference generator.
• sub-skills/skills-management/scripts/list_bundle_skills.py — offline bundled-agent-skill catalog listing.

Root references

• references/troubleshooting.md — cross-cutting install, daemon, source, auth, graph, and skills triage.
• references/repo-provenance.md — source commit, versions, evidence paths, and staleness triggers.
• references/repo-routing-metadata.json — structured placement for repo-skills-router import.