Shiroe is a local-first governance and continuity plane for persistent AI Work Graphs. It owns canonical state, policy and approval gates, executable capability invocation, verification, memory, and bounded handoff on the operator's machine.
Shiroe is not a harness, hosted backend, bundled connector collection, or model provider.
Current release: v3.0.0-alpha.1.
git clone https://github.com/kanadhiayash/shiroe.git
cd shiroe
python3 -m pip install -e .
python3 -m shiroe --helpInitialize a project:
python3 -m shiroe init /path/to/project --name my-project --privacy abstract --network-scope device-only
cd /path/to/project
python3 -m shiroe status --json
python3 -m shiroe doctor --jsonInstalled --help output is the source of truth.
| Command | Purpose |
|---|---|
init |
Scaffold a Shiroe project |
status |
Show project or Work Graph status |
plan |
Persist a Work Graph |
run |
Run or resume a Work Graph |
approve |
List, advise, or decide approvals |
memory |
Canonical memory operations |
verify |
Verify Work Graph or memory state |
handoff |
Compile a bounded handoff |
doctor |
Run semantic runtime health checks |
policy |
Inspect policy |
capability |
Inspect executable capabilities |
state |
Inspect canonical state |
version |
Print version |
- Canonical current state is
memory/state/shiroe.sqlite. - Canonical history is the hash-chained event log under
memory/events/. - Markdown views are projections, not authority.
- Default policy is deny unless an explicit allow applies.
- Only explicit human action creates an authorization record.
- Connectors are disabled by default.
python3 -m compileall -q shiroe
python3 -m pytest -q
python3 -m shiroe doctor --json
python3 -m shiroe state verify --json
python3 scripts/release_ready.pyRelease-readiness and public claims require fresh executed evidence.
MIT. See LICENSE.