Skip to content

Koopa0/koopa

Repository files navigation

koopa

English | 繁體中文

Status: private portfolio License: All Rights Reserved Go 1.26.1+

PostgreSQL Angular 22 MCP pgvector

koopa0.dev ↗

koopa is a private personal knowledge engine — your areas, goals, projects, notes, and writing in one place, with AI agents working inside it.

The agents share one source of truth: they read the same live state you do, instead of whatever you remember to tell them. You stay the only decision-maker — they search, draft, and propose; you decide what's kept.

Why this exists

You're juggling a lot — responsibilities you keep up, goals you're chasing, projects in flight, a daily list, things you're half-writing. What you want is help keeping it all moving: something that remembers where you left off, surfaces what's slipping, and works alongside you — not just another app you have to feed.

Most AI tools can't be that, because they forget. Every conversation starts from zero, and the more assistants you add, the more time you spend re-explaining yourself. koopa stores the work itself instead — your goals, projects, plans, and writing live in one place every agent can read. So an assistant can pull up your morning briefing, see what you finished yesterday, draft the next piece, and hand it back for your call, without you recapping a thing. It helps you carry the work; it never quietly takes it over.

How it works

The line that matters isn't human vs. agent — it's flow vs. decision. Agents handle the flow: they search, draft, and propose, in conversation with you. You handle the decisions: an agent can suggest a new goal or hand in a finished article, but it stays a draft until you accept it in the admin UI. They coordinate through the shared state, never by handing work to each other.

Who Role
You (Koopa) The only decision-maker
Claude Code Development sessions in this repo — search, build logs, content drafts
Hermes Curates a personal Obsidian vault on a schedule
Codex Development collaborator — repo work and code review

That split is the whole point. Agents can run freely — capture a todo, draft a proposal, push an article to your review queue — precisely because the commitments stay yours. Without the gate, autonomy just floods the system with things you never chose to keep.

What's inside

Planning & commitments. Your work is organized PARA + GTD style — areas, goals with milestones, projects, todos, and a daily plan. The daily plan doesn't silently roll yesterday's unfinished work forward; it resurfaces in your morning briefing, so you decide what stays.

Writing & publishing. Five kinds of content — articles, essays, build logs, TILs, and digests — move through a simple editorial flow from draft to published. An agent can hand in a finished draft and revise it after you send it back, but you're the only one who publishes.

Search. Agents search your published writing through a single tool, backed by hybrid search that blends keyword and meaning — so results stay relevant even when the wording doesn't match.

One history. Every change records who made it, so the whole system keeps a single, trustworthy timeline of what happened and when.

Scope and limits

This is a single-admin system by design: one person, several AI agents — no team accounts, no roles, no "share with a colleague." The admin side is private; only some content (articles, build logs, TILs) reaches the public site, and only after you publish it. Goals and private notes stay private — the private knowledge base lives in Obsidian, and koopa0.dev is just the publishing layer. If you want a team wiki or a Notion clone, this isn't it.


License

All Rights Reserved — see LICENSE.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors