Overview

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

The cloud build of my dotfiles, for agent sessions that run in a short-lived cloud VM rather than on one of my machines. It starts with Claude Code cloud sessions. It is the Ubuntu server build cut down to what a session uses: the compiled dot CLI, its pinned toolchain, my Claude Code settings and instructions, and the shared skills. Nothing is stowed and no services run.

# The cloud environment's setup script
curl -fsSL https://raw.githubusercontent.com/timmo001/dotfiles/distro/cloud/cloud/setup.sh | bash

How a session gets set up

Stage	What happens
Setup script	Runs once per environment: clones this branch, installs mise and the toolchain, builds `dot` and runs `dot cloud setup`. The environment snapshots the result
Session start	A Claude Code hook pulls the latest branch, clones the private overlay and adds the global agent instructions
Session	`dot`, `mise`, the skills and the instructions are ready; repositories attached to the session are cloned under `/home/user`

Core

Page	Why
Getting started	Create the cloud environment and check it works
Claude Code	Settings, instructions, skills and the session start hook
Configuration	What the private overlay provides in a session
Distros	The desktop and server builds, with their own docs sites
`dot` CLI	The commands that are useful in a session (command reference)

Agents

Page	Why
Overview	How Claude Code, OpenCode and the skills fit together
Skills	Shared catalogue and repo-local skills
OpenCode	The OpenCode config this repo publishes

This branch

Page	Why
Stow packages	The few packages kept, and why the rest are gone
Changes from the desktop	Every file this branch removes, changes or adds

Machine-readable docs

Build-time llms.txt bundles and a read-only docs MCP, generated from the same source as the site.

URL	Use
https://cloud.dotfiles.timmo.dev/llms.txt	Compact page index
https://cloud.dotfiles.timmo.dev/llms-full.txt	Full docs bundle
https://cloud.dotfiles.timmo.dev/mcp	Hosted MCP (search, page and navigation)
`/{route}.md`	One page as Markdown

Ask AI on the site is off.