PUKNOWLEDGE / MCP / 0.4.0 ALPHA

Let the next session
continue the right work.

Keep the current task, sources, revisions and approval boundaries outside chat memory. Change sessions or agents, then verify before continuing.

  • Local-first
  • Apache-2.0
  • Skill in preparation
PuKnowledge

01 / WHY IT EXISTS

Long projects fail in
the gaps between sessions.

The real risk is an old decision becoming current direction, a candidate becoming an approved fact, an untraceable source revision, or context silently crossing project boundaries.

CHAT MEMORY“I probably remember.”
PUKNOWLEDGE“Here is the project, revision and source.”

02 / SYNTHETIC WORKFLOW

One recovery. Three visible boundaries.

These panels use public synthetic fixtures. They are not private-project screenshots or replicas of a host UI.

Exact task recovery from a synthetic project
A new session restores the selected project, task ID, direction revision and next step. No write occurs.

03 / WHAT IT MANAGES

Manage complexity.
Keep decisions yours.

PuKnowledge is a workbench, not another model. It manages how agents use project material reliably.

01

Task continuity

Restore the current task, stage, next step and exact revision.

02

Sources & evidence

Connect conclusions to concrete sources, fingerprints and revisions.

03

Candidate vs approved

Keep working snapshots, candidates and approved truth separate.

04

Controlled writes

Preview first, then save with a baseline, fingerprint and idempotency key.

04 / HOST EVIDENCE

Protocol support and host evidence, kept separate.

These host results are maintainer-run calls using 0.3.3 and synthetic projects. They do not establish all 0.4.0 features, independent-user validation or compatibility with every host version.

HostEvidenceStatus
CursorDiscovery, preview/save, fresh-session recovery, isolationPASS
TRAEDiscovery, single save, fresh-session recovery, isolationPASS
Claude Code CLI 2.1.311Host tool calls; third-party model usedPASS
Other MCP hostsMay be protocol-compatible; requires host validationPENDING

Read the public validation scope and limits ↗

05 / INSTALL LOCALLY

Your projects stay
in your environment.

Requires Python 3.11 or newer. This is a 0.4.0 Alpha release candidate. The commands below pin that candidate commit; a public GitHub Release has not been created yet.

Read full installation guide ↗
LOCAL INSTALL
git clone https://github.com/pulapulapin/pu-mcp.git
cd pu-mcp
git checkout --detach 4668a868059dbddd4982fc9c99b8440ebe248692
python3 -m venv .venv
.venv/bin/python -m pip install -e .

Installation does not scan project content. You explicitly register a directory and project ID during initialization.

06 / HONEST LIMITS

It knows what was delivered.
It does not pretend to know everything.

READY ≠ TRUE

READY means selected sources were delivered as agreed. It does not prove truth, completeness or approval.

FILES REMAIN AUTHORITATIVE

Manuscripts, Canon and official material remain project files; the database manages state, relationships and versions.

NOT A TEAM CLOUD

The current product targets a single user and trusted local workspace, not multi-tenant SaaS.

Built for work that lasts weeks or months and cannot tolerate silent changes to project truth.

GitHub repository ↗Agensi Starter: in preparation, not live