Workstation System Map

Agentic Workstation

A fresh machine drifts — packages, shells, and AI-tool policies get assembled by hand and cannot be rebuilt.

Agentic Workstation provisions the machine reproducibly — packages, shell, developer tooling, LLM policy — and installs Agent Toolkit rather than duplicating it.

Agent Toolkit owns workspace, loop, and swarm execution; Workstation's retained runner applies provider and LLM policy to queued jobs.

Boot sequence (illustrative)

Step 1/6boot sequence

Empty machine. Thin workstation will provision — no embedded skills.

dots-skills install-toolkit

Optional connections.

HorneroConfig

optionally coexists with

Agentic Workstation

can provision host dependencies for

Agent Toolkit

provides capabilities and workspace commands to

Agentic Harness

Choose a responsibility

HorneroConfigWorkstationToolkitAgentic Harness

Interactive selection is unavailable. Project responsibilities:

HorneroConfig — Optional personal Linux configuration in the Personal DX graph — not a required predecessor of the workstation. HorneroConfig manages user-level configuration and optional media, while HorneroOS owns product defaults and desktop operations.
Workstation — Thin agentic-workstation. Provisions the machine via chezmoi: packages, shell, secrets, LLM policy, and thin dots-* helpers. Delegates all capabilities to agent-toolkit — ships no embedded skills.
Toolkit — Installed, not owned. agent-toolkit provides 105 skills · 18 agents · 10 loops · 9 profiles · 7 MCP, plugins, and the workspace, memory, loop, devcompanion, and swarm runtimes as a native V binary. The workstation provisions it; the Toolkit executes.
Agentic Harness — Persistent AI workspace layer — memory, personas, packs, indexed repos, and loop history. It drives the Toolkit CLIs and is not a second runtime. Canonical repo: ulises-jeremias/agentic-harness.

Health console

dots-doctorOS & chezmoi snapshot
dots-doctor --json | jqSwarm health
dots-doctor --issueMachine report
dots-doctor driftSkill drift
dots-devcompanion llm-statusLLM policy gate

Thin workstation verification

Thin workstation delegates all capabilities to agent-toolkit — installed via dots-skills install-toolkit (Homebrew, AUR agent-toolkit-bin, GitHub Release, or the PyPI launcher over the native V binary). The SKILL.md catalog is provided by the toolkit at runtime. Workstation-only runner logic (dev-companion/runner) is retained for host-level LLM policy. Agentic Harness (ulises-jeremias/agentic-harness) provides persistent workspace context — it is not the Toolkit.

No embedded: skills/*, loops/*, mcp/*, prompts/*, agents/*, packs/teams. Kept: dev-companion/runner, scopes/, telemetry/, pacman-hooks/.

GitHub Open Toolkit HorneroConfig Communitychezmoi init --apply ulises-jeremias/agentic-workstation

Relationships

Agentic Workstationcan provision host dependencies forAgent ToolkitOptional relationship
Agent Toolkitprovides capabilities and workspace commands toAgentic HarnessOptional relationship
HorneroConfigoptionally coexists withAgentic WorkstationOptional relationship

Edges describe responsibility, not required installation. Herdr and tmux are Toolkit UI backends, not additional relationship nodes.

Navigate the atlas

Agentic Workstation

Boot sequence (illustrative)

Profile

Health console

Thin workstation verification

Four projects, distinct responsibilities

Relationships