HOME

dots-ai Wiki

AI developer workstation layer — agents, skills, CLI helpers, and dev companion.

Welcome to the dots-ai knowledge base. This wiki covers installation, configuration, AI tooling, and operations.

---

What is dots-ai?

dots-ai standardizes the AI developer tooling layer across Linux, macOS, and Windows. It provisions:

Area	What you get
Skills	12 bundled + opt-in JIRA/Confluence packs for Claude Code, OpenCode, Cursor, Windsurf, Copilot, pi
Agents	13 specialized subagents (code review, architecture, security, TDD, etc.)
CLI	dots-* commands for health checks, skill management, updates, and LLM server
Dev Companion	LLM-powered background job runner with multi-provider support
MCP	Ready-to-use GitHub, ClickUp, Slack, and Notion server templates

---

Quick links

Getting Started

• Technical Quickstart — 5-step bootstrap
• Chezmoi Workflow — init, apply, and update flows
• Profiles — profile-to-package-group mapping
• Windows Setup — 3 installation modes for Windows

AI System

• AI Overview — skills system, agents, and the Ralph Loop
• Skills System — manifests, registry, compatibility, publishing
• Dev Companion — companion layers and delivery workflows
• LLM Providers — provider priority and configuration

Tools & Reference

• CLI Reference — all dots-* commands with subcommands
• MCP Templates — Model Context Protocol server setup
• Architecture — layered model and design principles
• ADRs — architecture decision records

Operations

• Security — security practices and scanning
• Troubleshooting — common issues and fixes
• Changelog — version history
• Contributing — how to contribute

---

Canonical documentation

Note

This wiki provides user-friendly summaries. The canonical (full-depth) documentation lives in the docs/ directory of the repository.