How blazeboyz0/7th-cmd works
7th cmd is a local-first natural-language command and computer-automation system. A user enters a command in the CLI; the application routes it through intent interpretation, target resolution, reasoning and planning, authorization, execution on the Linux platform, verification, and response generation. The repository also includes knowledge/context support, information processing, capability management, recovery, and task-state handling. The principal flow is documented in the README; sampled source confirms CLI wiring, grammar processing, planning, and execution dispatch. Other subsystem links are documented at a high level, not verified from their implementation.
Main entry points: command_subsystem.cpp Command subsystem · main.cpp Application entry · orchestrator.cpp Orchestrator · input_handler.cpp CLI input
Components 18
CLI and application
- Application entry
src/main.cpp - CLI input
src/cli/input_handler.cpp
Understanding and planning
- Intent grammar
src/engines/grammar/grammar_engine.cpp - Target resolution
src/systems/entity_resolution - Reasoning engine
src/engines/reasoning/reasoning_engine.cpp - Plan creation
src/engines/planning/planning_engine.cpp
Workflow coordination
- Orchestrator
src/orchestrator/orchestrator.cpp - Command subsystem
src/orchestrator/command_subsystem.cpp - Task state
src/orchestrator/task_state_manager.cpp
Safety and knowledge
- Knowledge and context
src/systems/knowledge - Capabilities
src/systems/capabilities - Authorization
src/systems/permissions/authorization_handler.cpp
Operations and results
- Information operations
src/systems/information/operation_engine.cpp - Execution engine
src/engines/execution/execution_engine.cpp - Linux platform
src/platform/linux/linux_platform.cpp - Outcome verification
src/systems/verification - Response generation
src/systems/response/response_generator.cpp
Other components
- User
Connections 17
- User → CLI input: enters command
README.md - CLI input → Application entry: provides input
src/main.cpp - Application entry → Orchestrator: submits request
src/main.cpp - Orchestrator → Command subsystem: routes command
README.md - Command subsystem → Intent grammar: interprets intent
README.md - Intent grammar → Target resolution: resolves target
README.md - Command subsystem → Reasoning engine: evaluates request
README.md - Command subsystem → Plan creation: creates plan
README.md - Orchestrator → Task state: tracks task
- Command subsystem → Knowledge and context: uses context
- Command subsystem → Capabilities: checks capability
README.md - Command subsystem → Authorization: checks authorization
README.md - Command subsystem → Execution engine: requests execution
README.md - Execution engine → Linux platform: dispatches operation
README.md - Command subsystem → Information operations: requests data operation
- Command subsystem → Outcome verification: verifies outcome
README.md - Application entry → Response generation: generates response
src/main.cpp