How timmo001/dotfiles works
The product is a personal Omarchy dotfiles environment managed by the dot command. Its central user workflow is first-use initialization, followed by health checks and recurring updates/stow; the CLI also exposes GitHub-backed repository workflows, dependency automation, skills, and service management. The graph emphasizes documented command dispatch and the sampled runtime entry points. Several command internals are unsampled, so their connections are shown only where the CLI specification documents dispatch.
Main entry points: spec.ts Command specification · index.ts CLI runtime · Services.ts Service status · Init.ts First-use setup
Components 21
CLI and setup
- Command specification
dot/src/cli/spec.ts - CLI runtime
dot/src/index.ts - First-use setup
dot/src/commands/Init.ts - Private clone bootstrap
Machine management
- Health checks
dot/src/commands/Doctor.ts - Doctor checks
dot/src/doctor/checks - Dotfiles update
dot/src/commands/Update.ts - System updates
dot/src/commands/SystemUpdate.ts - Stow management
dot/src/commands/Stow.ts - Service status
dot/src/commands/Services.ts
Git workflows
- Git commands
dot/src/git/commands - Git services
dot/src/git/services - Review helpers
dot/src/lib/pullRequestReviews.ts
Automation
- Dependency command
dot/src/commands/Dependencies.ts - Dependency automation
dot/src/deps - Skills commands
dot/src/commands/Skills.ts - MCP synchronization
dot/src/mcp/sync - Herdr integrations
dot/src/commands/HerdrAgents.ts
Other components
- Terminal user
- systemd user services
- GitHub
Connections 22
- Terminal user → CLI runtime: invokes
- CLI runtime → Command specification: resolves command
- Command specification → First-use setup: dispatches
- Command specification → Health checks: dispatches
- Command specification → Dotfiles update: dispatches
- Command specification → System updates: dispatches
- Command specification → Stow management: dispatches
- Command specification → Service status: dispatches
- Command specification → Git commands: dispatches
- Command specification → Dependency command: dispatches
- Command specification → Skills commands: dispatches
- Command specification → MCP synchronization: dispatches
- First-use setup → Private clone bootstrap: clones overlay
- Health checks → Doctor checks: runs checks
- Service status → systemd user services: queries units
- Service status → CLI runtime: opens logs via
- Git commands → Git services: uses services
- Git services → GitHub: requests data
- Review helpers → GitHub: queries GraphQL
- Dependency command → Dependency automation: runs automation
- Dependency automation → GitHub: reads repository data
- Herdr integrations → CLI runtime: executes status command