Repository navigation
Retulo 0.4.0rc1 — Local workspaces for AI agents
Pre-releaseSuperseded by v0.4.0rc2. Use rc2 for the standalone public core and corrected archive-inspection limits. This earlier candidate is retained for history.
Retulo gives AI agents a durable local workspace for file-producing work. Keep sources, output versions, decisions, progress and checks together; continue an identified task across conversations, rebuild affected steps and reuse versioned workflow recipes.
Start here
- English README · 简体中文 · 한국어
- Documentation
- Download and extract
retulo-0.4.0rc1.tar.gz, then follow its source-install instructions. The wheel contains the CLI/MCP core; the source archive also includes the Codex integration installer, examples, and guides.
Included
- Stable task identity and workspace continuity; original sources and numbered output versions.
- Separate file integrity, content-check and approval records.
- Declared workflow inputs and affected-step rebuilds with fixed execution snapshots.
- Versioned recipes that create new tasks with fresh checks and no inherited approvals.
- CLI and 29 MCP tools; preview-first Codex integration and guarded restoration.
- Runnable continuity and HTML/SVG report examples; English, Chinese and Korean documentation.
Validation and scope
GitHub-hosted macOS checks pass on Python 3.11 and 3.14, including 379 tests on each version, isolated installation/lifecycle/restore and package inspection. Actual CLI examples preserve the earlier outputs and sources. See the qualification record and exact Actions runs.
This is a preview release qualified for a local macOS filesystem. Your current agent runs the tools; the core does not call models, launch agents, execute recipe commands or publish results. Main Brain and external orchestrators are optional. Existing Codex clients must trust and connect the new integration. The operating installation is not replaced by downloading the package. PyPI installation and other OS/NAS/multi-host compatibility are not claimed.
MIT licensed. Dependency notices and license files are included. SHA256SUMS covers the attached wheel and sdist.