CLI Handbook

bijux-cli is the operator-facing runtime for the bijux command surface. It owns command normalization, runtime policy resolution, route execution, structured output, exit behavior, and plugin routing boundaries for the workspace.

This handbook is written for two outcomes:

• a reader can find the right page without reading the whole repository
• a reviewer can trace each claim to concrete crates/bijux-cli code

Open the runtime package Open the Python bridge package

Visual Summary

flowchart TB
    handbook["CLI handbook"]
    handbook --> runtime["bijux-cli"]
    handbook --> python["bijux-cli-python"]
    handbook --> sections["foundation | architecture | interfaces | operations | quality"]

Package Destinations

• bijux-cli owns native runtime semantics
• bijux-cli-python owns Python packaging and bridge compatibility
• stay in this handbook when the question spans both CLI packages

Code Anchors

• crates/bijux-cli/src/bin/bijux.rs
• crates/bijux-cli/src/bootstrap/run.rs
• crates/bijux-cli/src/interface/cli/dispatch.rs
• crates/bijux-cli/src/routing/parser.rs
• crates/bijux-cli/src/routing/registry.rs
• crates/bijux-cli/src/contracts/

Read This Handbook When

• the question is about bijux command behavior, flags, output, or exit codes
• plugin lifecycle, route ownership, or route conflicts are in scope
• CLI and REPL behavior must stay aligned
• a documentation claim needs to be verified against source and tests

Main Paths

• Foundation
• Architecture
• Interfaces
• Operations
• Quality

Related Handbooks

• Repository Handbook
• DAG Handbook
• Maintainer Handbook