SaladDay
2589384e68
Pi cannot be read as another linear JSONL stream. Its history is a tree with a durable leaf, orphan roots, branch summaries, and two compaction forms, so the active context is something the format states rather than something line order implies. The adapter keeps those semantics inside itself and projects the result into the existing canonical tables. Sessions are keyed by (normalized header cwd, header id) rather than by path, because Pi's --session-id lookup is project-local: two projects may reuse an id, while a move or an identical copy is still one session. Discovery covers both layouts Pi writes and fingerprints each file by mtime, ctime, size and inode, so a rewrite that preserves mtime is not read as unchanged. Abandoned branches are preserved rather than dropped. Visibility becomes three-state -- visible, inactive, hidden -- and helpers return only visible rows until includeInactive asks for the superseded path, labeling every row so a caller knows which it holds. Usage counts all three, because an abandoned call still spent tokens; message_count reports only the visible transcript. A committed MIT-licensed oracle transcribed from Pi 0.83.0 pins the context algorithms, and a fixed-seed differential runs 512 generated sessions against it on every test run. Schema changes are additive.
46 lines
1.2 KiB
Markdown
46 lines
1.2 KiB
Markdown
# Obelisk Skill
|
|
|
|
Explicit memory infrastructure for coding agents — a queryable SQLite evidence
|
|
layer over local Claude Code, Codex, Kimi Code, and Pi session history.
|
|
|
|
## Install with your agent (recommended)
|
|
|
|
Paste this into a coding agent with shell access:
|
|
|
|
```text
|
|
Install Obelisk by fetching and following this guide:
|
|
curl -fsSL https://raw.githubusercontent.com/tommy0103/obelisk/main/SKILL.md
|
|
```
|
|
|
|
The agent installs and verifies the CLI first, then asks whether this skill
|
|
should be installed for the current project or globally.
|
|
|
|
## Install manually
|
|
|
|
```bash
|
|
npm install --global @obelisk-apps/cli
|
|
obelisk install
|
|
```
|
|
|
|
The CLI is the executable runtime. This repository contains only the agent
|
|
instructions and progressive-disclosure references.
|
|
|
|
Then in any Claude Code session:
|
|
|
|
```
|
|
/obelisk <your question>
|
|
```
|
|
|
|
## Source
|
|
|
|
This repository is **auto-published** from the docs-only skill artifact of
|
|
[tommy0103/obelisk](https://github.com/tommy0103/obelisk). Do not open pull
|
|
requests here — contribute to the source repo instead.
|
|
|
|
## License
|
|
|
|
MIT — see [LICENSE](LICENSE) in this repository. The
|
|
[source repository](https://github.com/tommy0103/obelisk) is AGPL-3.0; this
|
|
skill documentation artifact is explicitly relicensed under MIT by the copyright
|
|
holder.
|