Dot Cli

Dot CLI

Use dot for bounded repository operations, local diagnostics, and agent-session archives. The installed command and its --help own the active interface. Dot also owns workstation login, setup, and cache workflows; native CLIs retain credentials and provider behavior. Skills own AI writing, release, and provider-source retention.

Workflow

1. Inspect the installed command with dot --version and the relevant --help; global options precede subcommands.
2. Select the guide for the requested operation. Diagnostics and previews do not authorize login, cleanup, publication, or remote writes.
3. Verify the command result at the requested level; local checks and hosted outcomes are separate evidence.

Task guides

• [authentication](references/authentication.md): Inspect and apply configured provider login, OAuth scopes, and account policy.
• [context](references/context.md): Measure discovery and instruction budgets in source or installed skill catalogs.
• [contracts](references/contracts.md): Resolve configuration, JSON output, exit codes, and session archive compatibility.
• [disk-space](references/disk-space.md): Audit workstation disk headroom, cache growth and shared tool versions before large downloads or builds.
• [operations](references/operations.md): Inspect repositories, diagnose workstation health, and manage session archives with dot.
• [orphans](references/orphans.md): Find files chezmoi deployed but no longer manages, then decide per path whether to keep, remove, or forget them.

Workflow ownership

Use [conventional-commit](../git-delivery/references/conventional-commit.md) for staged commits, [github-pull-request](../github-pull-request/SKILL.md) for PRs, and repository mise tasks for releases. Use dot login and dot setup for configured provider policy; inspect gh auth, gcloud auth, and gws auth directly for native diagnostics. dot login google excludes GitHub. Skip decisions require usable credentials and requested scope coverage; unknown status fails, and --force explicitly requests authentication. Skills own AI judgment; deterministic privacy and mutation boundaries still apply.

Documentation

• fmind/dot — setup, implementation, and repository tasks.
• [Daily workflows](references/daily-workflows.md) — command examples for repositories, sessions and statistics, cleanup, publication, and completions.
• [CLI migration](references/cli-migration.md) — command changes, date boundaries, JSON selectors.
• Releases: fmind/dot · changelog
• Companion skills: [agent-usage](../agent-usage/SKILL.md), [mise](../mise/SKILL.md), [gws](../gws/SKILL.md), [gcloud](../gcloud/SKILL.md).

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: fmind
• Source: fmind/dot
• License: MIT
• Homepage: https://fmind.dev

Install and usage instructions live in the source repository linked above.