Your coding agent forgot. Qiju kept the record.
Local-first, structured session records that let Claude Code, Codex, Kiro, Cursor, and future agents continue from verifiable development history.
Installation · How to Use · Common Scenarios · In Depth · 中文
Qiju is your secretary. You are the boss — you run the projects and make the calls; say what's worth keeping: history, handoffs, where the docs live. Qiju never copies what's already in your files — the code says what the project is; Qiju records how it grew from nothing into something great. Ask later, and Qiju remembers everything — no matter which agent you are using.
What Qiju can do:
- One sentence becomes a record — say "record the handoff" and a structured record (title, tags, next steps, the full story) is written for you.
- Answers like it was there — "what did we do yesterday?", "why didn't we use xyz?" — ask in plain words, get back the actual record, not a guess.
- Memory across projects — search this project, another project by name, or everything you have ever recorded; a feature you built last month is one question away from being reused.
- Finds the gold —
/qiju-reviewturns last week's records into concrete improvements for the next round of development.
The trait that matters most: your records outlive everything — the session, the compacted context window, even the agent vendor. They are plain local files on your machine: no cloud, no embeddings, no lock-in.
Across platforms: one record store, every agent. Qiju installs the same three skills into Claude Code, Codex, Kiro, and Cursor — record in one, ask in another, and nothing is lost when you switch.
Note
Curious about the design, the record format, the storage architecture, and the current status? Read Qiju in depth.
Two minutes, nothing to install — a simulated session where Claude Code writes the record and Codex picks it up:
▶ Play the interactive demo · 中文版演示
uv tool install qiju
qiju --versionFor pipx/pip installs and the source install, see Qiju in depth.
Run qiju init from the root of each project you want to record:
cd /path/to/your/project
qiju init --host claude,codex,kiroWhat it sets up, --host all, and user-level defaults: see
Qiju in depth.
uv tool upgrade qijuInstalled with pipx or pip? See Qiju in depth.
The CLI upgrade does not rewrite the skill files already installed in your projects. One command brings every registered project up to date:
qiju update --dry-run # preview what would change
qiju update # refresh skills in all registered projectsqiju update is registry-first. If you have older Qiju projects that were
initialized before the registry existed, run qiju update --scan-projects once
to discover them and backfill the registry. Your records are never touched by an
update — only the skill files are refreshed.
Say what you want kept, the way you would tell a person:
/qiju-log handoff record
/qiju-log sum up our discussion
/qiju-log record that we will do xyz tomorrow
The agent turns your words into a structured record — title, tags, search terms, next steps, and a full Markdown body — and verifies it landed in the store.
Tip
Treat Qiju as your secretary: just tell it what you want to record, and Qiju will do it for you.
Anything that was recorded, you can get back by asking:
/qiju-search what did we do yesterday?
/qiju-search why did we use (or not use) xyz?
/qiju-search I remember we developed this feature in my project Y — what are the related files?
Search works within the current project, across a project named in your question,
or across all your projects; a record id (qiju show '<uuid>:1') retrieves one
exact record.
Tip
Qiju is your secretary — if it was recorded, just ask. You can even ask:
/qiju-search I want to build project X, it is about Y — what existing features in my projects can be reused?
A powerful skill: it reads your recent project and global records, extracts the mistakes, lessons, and repeated friction hiding in them, and proposes concrete improvements to how you work next. It only recommends — it does not edit any files unless you ask.
/qiju-review read the last 7 days of records — anything we can optimize in the
following development?
The fastest way to get value from Qiju is to make two moments a habit: the end of a session and the start of the next one.
| Moment | What you say to the agent |
|---|---|
| Ending a working session | /qiju-log Record what we did today, what we decided, and what's next. |
| Starting the next morning | /qiju-search What did we do yesterday, and what's still pending? |
| Switching agents mid-task | In Codex: $qiju-search token refresh decision — same record store, different host. |
| Before retrying something | /qiju-search Did we already try caching the auth token? What happened? |
| After a release | /qiju-log Record: released 0.5.11 to PyPI, all gates green, skills refreshed in all projects. |
| Recording a decision | /qiju-log Record the decision: keep 0.5.9, monitor record quality; R1/R2 rejected. |
| Weekly self-improvement | /qiju-review What lessons from this week should change how we work? |
| Following up on a recorded change | I just updated skill X — check record <uuid>:1, then test skill X in this project. |
Qiju is small on purpose, but the handoff problem is large. Useful contributions include broken host workflows, real handoff cases, Linux verification, docs clarity, and tests for record durability.
Try Qiju on one real coding session. Switch agents, search the record, and tell us where the handoff still breaks — in an issue, or on Discord.
Licensed under the Apache License 2.0. Copyright 2026 Jason Shen.