⌨️ CLI Commands Reference

HelseCLI uses a set of global and mode-specific commands to manage the AI and your project.

Command Line Interface Reference

HelseCLI utilizes a comprehensive suite of global and mode-specific commands to facilitate project management and AI assistance.

Global Commands

These commands are available across all operational modes.

CommandFunction
!homeReturn to the primary HelseCLI interface.
!exitTerminate the current session or operational mode (requires confirmation).
!helpRetrieve the command manifest for the active mode.
!mAccess the model selection interface.
!model <name>Programmatically transition to a specified inference model.
!keysDisplay the keyboard shortcut reference.

Code Mode Commands

The following commands facilitate control over autonomy levels and code validation protocols.

CommandFunction
!aToggle Autonomous Agent Mode for multi-stage task orchestration.
!stepsRetrieve the session audit trail and operation history.
!planEnable implementation plan verification prior to developmental changes.
!buildEnable non-interactive tool execution (Build Mode).
!verifyToggle automated code validation and static analysis.
!pause / !flowToggle Pause-on-Output Mode for itemized execution review.
!sandboxRetrieve the current isolation environment status (Local, Docker, or E2B).

Pause-on-Output Logic (!pause / !flow)

This toggle controls whether the autonomous agent interrupts the execution loop after each command for manual review.

Logic Disabled (Sequence Flow):

State: OFF - The agent executes the task chain without terminal interruption.
  • Asynchronous execution of background processes.
  • Immediate transition to successive task items.
  • Optimized for high-velocity development.

Logic Enabled (Review Flow):

State: ON - The system pauses the execution loop for manual verification.
  • Active for all computational tool calls (run_command, execute_code, etc.).
  • Presents execution telemetry within a dedicated review panel.
  • Mandates user input to proceed to the next logic state.

Technical Use Cases:

  • Diagnostics of complex autonomous workflows.
  • Granular review of execution telemetry.
  • Mitigation of autonomous logic risks in high-sensitivity environments.

Document Mode Setup Options

The following inputs are supported during the interactive configuration phase:

InputFunction
backRevert to the preceding configuration state.
resetTerminate the current setup and re-initialize configuration.
defaultApply system-standard parameters to all remaining prompts.

Core Launch Commands

Execute these commands directly from the system shell:

# Initialize primary HelseCLI interface
python helsecli.py

# Initialize specific operational modes
python helsecli.py code
python helsecli.py chat
python helsecli.py document

# System version verification
python helsecli.py version

# System installation protocol
python helsecli.py install