Skip to content

Document Pi Witan setup and target isolation#8

Open
feoh wants to merge 1 commit into
mainfrom
docs/pi-witan-memory-destinations
Open

Document Pi Witan setup and target isolation#8
feoh wants to merge 1 commit into
mainfrom
docs/pi-witan-memory-destinations

Conversation

@feoh

@feoh feoh commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

What are the relevant tickets?

N/A

Description (What does it do?)

  • Adds explicit Pi setup instructions to docs/agent-memory.md, including ~/.pi/agent/mcp.json and ~/.pi/agent/extensions wiring.
  • Splits local setup into separate Claude Code and Pi sections.
  • Documents named Witan targets for work/personal graph isolation so personal projects do not write to the work memory graph.
  • Updates MCP snippets to show WITAN_TARGET usage and the witan serve command.

How can this be tested?

  • Review docs/agent-memory.md and confirm it includes Pi-specific MCP and extension setup.
  • Review the target examples and confirm work and personal use separate server destinations.
  • Run uvx prek run --all-files.
  • Run git diff --check.

Additional Context

The target isolation behavior was introduced in #5. This PR documents the setup path for that feature, especially for Pi users.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the docs/agent-memory.md documentation to introduce "Named targets for destination isolation," which helps users keep work and personal agent memories separate. It includes configuration instructions for ~/.config/witan/config.toml, updates MCP server setups for Claude Code and Pi to use WITAN_TARGET, and details Pi extensions. The review feedback highlights a few improvements: ensuring the ~/.pi/agent/extensions/ directory is created before symlinking, removing a stray code block fence, and cleaning up unnecessary vertical whitespace inside several code blocks to improve rendering.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread docs/agent-memory.md
Comment on lines +194 to +199
ln -sf \
"$REPO/configs/pi/extensions/codegraph.ts" \
~/.pi/agent/extensions/
ln -sf \
"$REPO/configs/pi/extensions/workflow-context.ts" \
~/.pi/agent/extensions/

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

If the ~/.pi/agent/extensions/ directory does not already exist, the ln commands will fail or behave unexpectedly. Adding mkdir -p ~/.pi/agent/extensions/ beforehand ensures the directory exists and the symlinks are created correctly.

Suggested change
ln -sf \
"$REPO/configs/pi/extensions/codegraph.ts" \
~/.pi/agent/extensions/
ln -sf \
"$REPO/configs/pi/extensions/workflow-context.ts" \
~/.pi/agent/extensions/
mkdir -p ~/.pi/agent/extensions/
ln -sf \
"$REPO/configs/pi/extensions/codegraph.ts" \
~/.pi/agent/extensions/
ln -sf \
"$REPO/configs/pi/extensions/workflow-context.ts" \
~/.pi/agent/extensions/

Comment thread docs/agent-memory.md
| **`memory_update` tool** | Expose `update_memory` query as a first-class tool. v1 workaround: `memory_get` + `memory_store`. |
| **`link_supersedes` / `link_applies_to` tools** | Expose edge mutations so agents can express relationships between memories without the CLI. |
| **`memory_delete` tool** | Requires a separate `delete.gq` file (D₂ constraint: cannot mix deletes with inserts/updates). Deliberately omitted to prevent accidental data loss in v1. |

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

There is a stray closing code block fence ``` on line 1598 that has no matching opening fence. Additionally, this newly added empty line on line 1597 is unnecessary. Please remove both the empty line and the stray closing fence on line 1598.

Comment thread docs/agent-memory.md
used in this session:

```

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Adding empty lines at the very beginning and end of code blocks (as seen here and in several other places in this file, e.g., lines 1484, 1487, 1495, 1499, etc.) introduces unnecessary vertical whitespace inside the rendered code blocks. It is cleaner to remove these empty lines so the code blocks render with standard padding.

@blarghmatey

Copy link
Copy Markdown
Member

Did you try the witan setup command? That is intended to handle the MCP config setup, skill registration, etc.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants