Repository navigation
Nano now supports native Supervisor, Reviewer, and Consultant workflows, interactive conversations in HQ, and standalone coding sessions.
Added
- Native HQ conversations:
/executoropens a direct workspace session;/attachconnects to running or historical managed conversations. Includes streaming previews, tool results, queued steering, usage, scrolling, and cancellation. - A standalone
ferrus-nanobinary for Git and non-Git workspaces, without HQ, registration, task claims, orferrus.db. Supports headless requests,--interactiveterminal conversations, and journal-backed--resume. - Native Supervisor profiles for planning, task preparation, specification creation, and archival. Authoring presents the completed draft for explicit host confirmation before writing.
- Task-scoped Reviewer and Consultant profiles. Review reads the frozen submitted Git tree; consultation reads the attached Executor workspace. Both reuse existing Ferrus lifecycle operations.
Changed
- Move the OpenAI-compatible provider to svir 0.1.7 behind Nano's bounded reqwest transport. Engine-owned retries, budgets, journal compatibility, and unknown-effect recovery remain intact.
- Improve shared HQ/standalone conversation rendering, editing, scrolling, confirmation screens, and terminal cleanup.
- Add installer component selection through
--components,-Components, orFERRUS_INSTALL_COMPONENTS, acceptingall|ferrus|nano. Installers use the shared release archive and preserve unselected installed binaries. - Standardize Rust code style, replace production
unwrap()/expect()calls, and split oversized modules. Clippy and CI enforce the new restrictions. - Update neva to 0.9.0 and consolidate Nano documentation under
docs/ferrus-nano/.
Compatibility
- Rust API changes: graph and memory digest/snapshot helpers now return
Result. New serialization-error variants also require updates to exhaustive downstream matches. - Native Nano review requires a frozen Git submission and its frozen graph view. Submissions without that evidence remain available for review by another Supervisor.
- Nano remains experimental. Existing task states, lease accounting, submission gates, and approval/rollback semantics are preserved.
Setup
Prebuilt archives include both binaries. Source installations require explicit Nano features:
cargo install ferrus --version 0.6.0-alpha.1 --locked --profile dist \
--features nano-openai,nano-mcpWith private provider settings configured, start a standalone conversation:
ferrus-nano --workspace /path/to/project --interactiveSee the Nano setup guide and standalone guide.
Full Changelog: 0.5.0-alpha.1...0.6.0-alpha.1