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.
Directories
¶
| Path | Synopsis |
|---|---|
|
Package agent runs an autonomous agent loop that executes tasks using LLM-driven tool calls.
|
Package agent runs an autonomous agent loop that executes tasks using LLM-driven tool calls. |
|
cmd
|
|
|
ii
command
Package main implements the ii CLI tool.
|
Package main implements the ii CLI tool. |
|
Package habit implements loading and managing habit instruction documents.
|
Package habit implements loading and managing habit instruction documents. |
|
internal
|
|
|
agents
Package adapter defines the interface for CLI agent backends and provides implementations for different agent binaries.
|
Package adapter defines the interface for CLI agent backends and provides implementations for different agent binaries. |
|
config
Package config handles loading project and global configuration files.
|
Package config handles loading project and global configuration files. |
|
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. |
Click to show internal directories.
Click to hide internal directories.