hj-cli

hj-cli is the installable command-line package for the hj workspace.

It provides:

• hj
• handoff
• handon
• handover
• handoff-detect
• handoff-db
• handup

Install From a Checkout

From the repository root:

hj install

Manual equivalent:

env RUSTC_WRAPPER= cargo install --path crates/hj-cli --bins --force --root ~/.local

This refreshes all seven binaries in ~/.local/bin.

Update To the Latest Release

hj update

hj update-all is a synonym for the same release update path.

Top-Level Commands

hj detect
hj handoff
hj handon
hj handover
hj handoff-db
hj handup
hj install
hj update
hj update-all
hj refresh
hj reconcile
hj audit
hj close

Architecture

• src/main.rs and src/bin/*.rs are composition roots only. They delegate into the shared library crate.
• src/lib.rs owns command dispatch and keeps CLI parsing separate from command execution.
• src/cli.rs contains Clap types only.
• src/install.rs contains install and update concerns only.
• src/handoff.rs contains handoff, handon, handover, detect, reconcile, and SQLite-backed triage workflows.
• src/handup.rs contains tree survey, report synthesis, checkpointing, and summary rendering for handup.

Notes

• hj install uses the current checkout and should be run from an hj repository.
• hj update installs the latest published hj-cli package.
• handoff, handon, handover, handoff-detect, handoff-db, and handup are thin aliases that route into hj.
• Runnable demos for the command surface live in ../../examples/README.md.