dot-cli

A command-line toolkit for checking a development environment, managing repositories and a local k3d Kubernetes cluster, recording agent sessions, and cleaning caches. Kubernetes is software for running containers, while k3d runs a small local Kubernetes cluster.

In plain words
What is it for?
Use it to verify tools and secrets, inspect Git, Docker, and cluster status, pull repositories, prepare releases, manage agent sessions, and reclaim disk space.
Why use it?
It puts several development and environment checks in one command-line tool instead of requiring separate procedures.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/fmind/dotfiles/dot-cli
Any agent
npx skills add fmind/dotfiles --skill dot-cli
Clone the repo
git clone --depth 1 https://github.com/fmind/dotfiles

Made for: Claude Code, Codex.

Per session 47 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,256 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00047 $0.01256
Opus 5 $0.00023 $0.00628
Sonnet 5 $0.00009 $0.00251
Haiku 4.5 $0.00005 $0.00126

Measured 3d ago against content hash a5d6403c6df2, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

dot-cli scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/dot-cli/SKILL.md · 75 lines

How it starts

The opening of the file, as written. The whole thing — 75 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Dot CLI

dot is the unified CLI of fmind/dotfiles (source in dot/, built to ~/.local/bin/dot). All subcommands have single-letter aliases. Use dot <command> --help for precise flag usage.

Commands

Command Alias Purpose
dot verify v Sanity-check environment, tools, secrets, and install freshness (--json, --fix)
dot status s Unified git, docker, and k3d status summary (--json)
dot pull p Pull repos declared in ~/.config/dot.yaml (--push to push)
dot commit c Generate Conventional Commit via AI (agy) from staged changes
dot pull-request pr Draft PR description via AI and invoke gh pr create
dot release r Prepare, tag, and publish dotfiles release (see dot-release)
dot cluster k Manage local k3d cluster and gather diagnostic evidence
dot prune x Reclaim disk space from agent session logs and dev/tool caches
dot agent a Agent session management (doctor, hook, session)
dot notify n Trigger desktop notifications for agent hooks or alerts
dot chezmoi m chezmoi configuration management (clean subcommand)
dot chezmoi clean m c Find and delete $HOME orphan files unmanaged by chezmoi
dot config f Scaffold (init), edit, show, and validate ~/.config/dot.yaml
dot login l OAuth login wrapper (github, workspace, gcp, clasp)
dot setup u Enable GCP APIs on active Workspace project
dot completion g Generate fish autocompletions for dot and tools
dot context t Export bounded, secret-scanned project context pack
dot version i Print binary version and VCS revision

Read the full file on GitHub · 75 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 75 lines · 47 tokens per session scan A a5d6403c6df2

Subscribe to this mod's changes

dot-cli is a skill published in the GitHub repository fmind/dotfiles (4 stars, last pushed 3d ago), licensed MIT. It adds 47 tokens to every session and 1,256 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

homelab-backups

Backup coverage rules for the homelab (alpha, bravo, Synology NAS, DO Spaces offsite). Activate whenever deploying a NEW service/compose project/database to alpha or bravo, adding a docker volume with state, decommissioning a service, or when the user mentions backups, restic, восстановление/restore, NAS storage, or…

pkarpovich/environment · 0 tokens

dokploy-deploy

This skill should be used when user asks to "deploy with Dokploy", "use Dokploy Cloud", "manage self-hosted Dokploy", "deploy Docker Compose on Dokploy", "manage Dokploy databases", "configure Dokploy domains", or "look up Dokploy CLI commands".

fcakyon/claude-codex-settings · 63 tokens

dotfiles-bootstrap

Bootstrap a workstation with the dotfiles framework. Takes a GitHub user / owner+repo / explicit clone URL and runs dot init (which shells out to chezmoi) with the right safety prompts. Honors the active agent profile (ask / plan / apply / audit) so it defaults to dry-run in safer modes and full apply in apply.

sebastienrousseau/dotfiles · 88 tokens

vibe

Delegate a coding task to a cheap AI model (Mistral Vibe by default, but any provider Vibe knows about — DeepSeek, Gemini Flash, etc.) and supervise the result via git diff. Claude orchestrates, the cheap model codes. Claude consumes 500-1500 tokens per delegation regardless of how many file reads the delegate does…

sebastienrousseau/dotfiles · 137 tokens

aiq-research

Use when asked to run deep research or AI-Q research through a reachable NVIDIA AI-Q Blueprint backend.

laurigates/dotfiles · 25 tokens

obsidian-bases

Obsidian Bases database feature for YAML-based interactive note views. Use when creating .base files, writing filter queries, building formulas, configuring table/card views, or working with Obsidian properties and frontmatter databases.

laurigates/dotfiles · 49 tokens