Home

KepCup Wiki

KepCup is an open-source, local-first Personal Agent app: you talk with Bots on your Mac, Windows, or Linux machine; each Bot remembers you, keeps its own wiki and skills, and does real work in a separate execution loop. Data stays on your computer by default.

Slogan: Create a team that serves only you.

This wiki is the English design map for how the product fits together. The Chinese source drafts live in the repo under docs/design/. Each page starts with a Source: line pointing back to that file.

Start here

Page	What it covers
Overview	Product shape, dual loops, project teams, isolation
01-Conversation	Contacts, DMs, project teams, messages, delete semantics
02-Execution	Reply turn vs task, mailbox, settlement, proactive messages
30-Supervisor-and-Tasks	The two-layer loop model in depth (D75)
41-Project-Team	Project sessions: routing, episodes, project wiki (D92)
03-Bot	Bot profile, lifecycle, Butler
09-Tech-Stack	pi agent loop, Electron, Svelte

Major sections

• Core — conversation, execution, bot, memory, wiki/skills
• Runtime — local client, workdir, sandbox, storage, isolation, permissions
• Capabilities — models, browser, search, MCP, mail, sensors, widgets
• Product surfaces — UI, workbench, narrow layout, task run view, file cards
• Team & control — Butler, delegation, project team, remote control, headless server
• Integrations — connected apps, external ACP agents, supplier, share extension

Canonical decisions (D1–D102) are summarized on Decision-Log. Full decision tables remain in docs/design/README.md.

Status notes

Many pages mark implemented, partial, or not implemented. Prefer those labels over assuming everything in the design is shipping.