# Dotfiles

> My dotfiles for cloud agent environments, starting with Claude Code cloud sessions.

## Docs

- [Overview](https://cloud.dotfiles.timmo.dev/): My dotfiles for cloud agent environments, starting with Claude Code cloud sessions.
- [Getting Started](https://cloud.dotfiles.timmo.dev/getting-started): Create a Claude Code cloud environment that runs this build, and check it works.
- [Configuration](https://cloud.dotfiles.timmo.dev/configuration): What the public branch and the private overlay each provide in a cloud session.
- [Distros](https://cloud.dotfiles.timmo.dev/distros): The distro branches of these dotfiles and the docs site each one publishes.

## Claude Code

- [Claude Code](https://cloud.dotfiles.timmo.dev/claude/overview): The Claude Code settings, instructions, skills and hook a cloud session gets.

## dot

- [The dot Command](https://cloud.dotfiles.timmo.dev/dot/overview): The dotfiles CLI, and the commands that are useful in a cloud session.
- [Command Reference](https://cloud.dotfiles.timmo.dev/dot/commands): Every dot command, alias, flag and example, generated from the CLI command tree.

## Agents

- [Agents](https://cloud.dotfiles.timmo.dev/agents/overview): How Claude Code, OpenCode and the shared skills fit together in this build.
- [Skills](https://cloud.dotfiles.timmo.dev/agents/skills): Shared agent skills catalogue and repo-local skills.

## OpenCode

- [OpenCode](https://cloud.dotfiles.timmo.dev/agents/opencode/overview): Primary coding-agent harness and published config.
- [Agents](https://cloud.dotfiles.timmo.dev/agents/opencode/agents): OpenCode agents defined in this repo.
- [Commands](https://cloud.dotfiles.timmo.dev/agents/opencode/commands): OpenCode slash commands defined in this repo.
- [Plugins](https://cloud.dotfiles.timmo.dev/agents/opencode/plugins): OpenCode lifecycle plugins defined in this repo.

## This branch

- [Stow Packages](https://cloud.dotfiles.timmo.dev/stow): The few packages the cloud build keeps, and why it drops the rest.
- [Changes from the desktop](https://cloud.dotfiles.timmo.dev/changes): What the Cloud branch removed, changed and added compared with distro/arch-omarchy-quattro.

## Agent skills

- [dotfiles](https://cloud.dotfiles.timmo.dev/.well-known/agent-skills/dotfiles/SKILL.md): Read the Dotfiles docs instead of answering from memory. My dotfiles for cloud agent environments, starting with Claude Code cloud sessions. Use when a task involves Dotfiles: how it works, how to set it up or configure it, or its API.

## Agent resources

- [llms-full.txt](https://cloud.dotfiles.timmo.dev/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://cloud.dotfiles.timmo.dev/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://cloud.dotfiles.timmo.dev/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://cloud.dotfiles.timmo.dev/openapi.json.
- [MCP server](https://cloud.dotfiles.timmo.dev/mcp): Streamable HTTP Model Context Protocol server with search_docs, get_page, list_pages, and get_navigation tools, plus every page as a resource. Discovery document: https://cloud.dotfiles.timmo.dev/.well-known/mcp.json
- [Agent skills](https://cloud.dotfiles.timmo.dev/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://cloud.dotfiles.timmo.dev/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://cloud.dotfiles.timmo.dev/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://cloud.dotfiles.timmo.dev/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://cloud.dotfiles.timmo.dev/sitemap.xml): Every indexable page URL with its last-modified date.