README
¶
Incrementum
Incrementum is a CLI for managing focused work with todos, sessions, and
Jujutsu-backed workspaces. The main entrypoint is the ii command, which wraps
the public Go packages defined in this repo.
Core concepts
- Workspace: a pooled, isolated working copy managed via Jujutsu.
- Todo: a task record stored in a dedicated branch for tracking.
- Session: a unit of work that acquires a workspace to complete one todo.
- Job: orchestration for running LLM agent work on todos.
Repository layout
cmd/ii: CLI entrypoint and subcommands.workspace/: workspace pool implementation.todo/: todo storage and operations.session/: session lifecycle and helpers.internal/: shared internal helpers and infrastructure.specs/: behavioral specifications for each package.
Development
- Specs live in
specs/README.mdand describe intended behavior. - Run
go tool run testto execute the test suite (unit/integration tests andgo fixconformance). Seetasks.tomlfor individual tasks.
Documentation
Source Files
¶
Directories
¶
| Path | Synopsis |
|---|---|
|
Package habit implements loading and managing habit instruction documents.
|
Package habit implements loading and managing habit instruction documents. |
|
internal
|
|
|
editor
Package editor provides utilities for interactive editing with $EDITOR.
|
Package editor provides utilities for interactive editing with $EDITOR. |
|
Package todo implements a Jira-like todo tracker for jujutsu repositories.
|
Package todo implements a Jira-like todo tracker for jujutsu repositories. |
|
Package workflow executes data-driven workflows: directed graphs of shell commands with conditional routing and a persistent scratchpad for inter-node message passing.
|
Package workflow executes data-driven workflows: directed graphs of shell commands with conditional routing and a persistent scratchpad for inter-node message passing. |
Click to show internal directories.
Click to hide internal directories.