💻 Code Mode Guide
Code Mode is the primary interactive environment for development. It provides the AI with a comprehensive set of tools to read, write, research, and execute code within your project.
Code Mode Reference
Code Mode is the primary integrated development environment within HelseCLI. It facilitates complex engineering tasks by providing the AI assistant with a comprehensive toolset for source code analysis, synthesis, research, and execution.
Initialization
To initiate a Code Mode session, execute the following command:
python helsecli.py code
Functional Capabilities
1. Source Code Analysis and Synthesis
HelseCLI facilitates direct interaction with the project filesystem to perform complex developmental tasks:
- Navigation: Search for specific functional implementations and definitions.
- Contextual Retrieval: Perform indexed reads of source files to build context.
- Automated Refactoring: Apply complex logic changes and structural improvements programmatically.
2. Validated Execution
Test and validate functional logic within the conversation context.
- Execution Logic: HelseCLI executes scripts within the defined sandboxed environment and captures the resulting standard output and error streams.
3. Integrated Research Retrieval
Access external technical documentation and repositories directly via the interface.
- Mechanism: The AI assistant utilizes web retrieval tools to gather technical specifications and implementation details, providing synthesized snippets tailored to the current context.
Operational Commands
The following commands facilitate session management and logic tuning:
| Command | Function |
|---|---|
!a | Toggle Autonomous Agent Mode. |
!m | Access the model selection interface. |
!steps | Retrieve the session audit trail. |
!plan | Require a formal implementation plan prior to file modification. |
!build | Enable non-interactive execution of tool operations. |
!verify | Activate automated code validation (linting and static analysis). |
Developmental Best Practices
- Contextual Management: Utilize the
/initcommand or deploy anAGENTS.mdfile to provide architectural context. - Modular Task Execution: Break down complex features into discrete components (e.g., data models, core logic, validation suites) to maximize accuracy.
- Verification Protocols: Enable
!verifyto ensure generated code adheres to project-specific quality and type-checking standards.
Security Controls
By default, HelseCLI operates under a manual authorization protocol. The system mandates user approval for all write operations and computational executions, displaying the proposed payload or script for review.