dotfiles-public

Tips, gotchas, and recipes for the gws CLI (googleworkspace/cli). Read before running any gws command. Grammar is `gws <service> <resource> <method> --params '{JSON}'`; every API argument (fileId, documentId, spreadsheetId, calendarId, range, fields, q) goes inside `--params`, NOT as a flag like `--fileId`. Discover params with `gws schema <service.resource.method>`, not `--help`. Also covers Doc comment anchored text, stray download files, and other API quirks. Triggers on any use of `gws drive`, `gws docs`, `gws sheets`, `gws gmail`, `gws calendar`, or related Google Workspace CLI invocations.

Read and manage Slack: messages, threads, channels, users, files, search, saved items, drafts, sidebar sections. Load this BEFORE running any `slack` command - the CLI has its own grammar (`slack thread list`, `slack message get`, `slack channel list --query`), NOT Slack Web-API method names (no `conversations.replies`, `channel find`, `message read`).

Convert Markdown files with Mermaid diagrams to styled PDF. Use when user wants to export/convert markdown to PDF, generate PDF documentation, or create printable documents.

Agent-first Confluence CLI: sync spaces to Markdown, read pages (page list/get/children/ancestors/tree), inspect spaces (space info/list), attachments, CQL search, comments, labels, users, and write content (page create/update/delete, attachment upload, comment add including inline, label add/remove) with storage, ADF, or Markdown bodies on stdin

Manage Todoist tasks, projects, labels, filters, sections, comments, reminders, and workspaces via the `td` CLI. Use when the user wants to view, create, update, complete, or organize Todoist items, or mentions tasks, inbox, today, upcoming, projects, labels, or filters.

Generate polished architecture and flow diagrams from text using D2. Use when creating architecture diagrams, flowcharts, decision trees, sequence flows, ERDs, or any text-to-diagram work where Mermaid's auto-routing produces amateur output. Triggers on "make a diagram", "diagram this", "draw the architecture", "flowchart", or any d2/diagram request.

Read, create, and update Confluence pages via the `mcp__atlassian__*` tools. Load before calling `createConfluencePage`, `updateConfluencePage`, `createConfluenceFooterComment`, `createConfluenceInlineComment`, or any time you're about to write Confluence content. Covers the ADF nested task-list gotcha, the inline-comment destruction rule, and what content format to use when fetching vs writing.

MANDATORY collaborative AI partner via Codex MCP. Use mcp__codex__codex to start a thread and mcp__codex__codex-reply to continue. ALWAYS load this skill and engage Codex for any significant planning (not just complex - any non-trivial decision with tradeoffs), architectural choices, tradeoff analysis, code reviews, second opinions, and rubber-ducking. Engage Codex BEFORE finalizing a plan or review, not after.

Chat with Glean Assistant from the command line. Use when asking questions, summarizing documents, or getting AI-powered answers about company knowledge.

Retrieve, summarize, and inspect documents indexed by Glean. Use when getting document content, summaries, permissions, or metadata by URL.

Look up people, teams, and custom entities in Glean. Use when finding employees, org structure, team members, or expertise.

Search across company knowledge with the Glean CLI. Use when finding documents, policies, engineering docs, or any information across enterprise data sources.

Work autonomously on a task until it is complete or the human stops you, without pausing to ask permission between steps. Use when user says "/auto-loop", "loop forever", "keep going", "run overnight", "don't stop", "run autonomously", "work until it's done", "finish this without me", or when the user is leaving and wants work to continue unattended. Applies to both open-ended iteration (optimization, experimentation, search) and finite tasks that need to be driven to completion (migrations, refactors, implementing a feature, fixing a list of issues).

Explore external GitHub repositories by cloning them locally via `git grab` and using the Explore agent for codebase analysis. Triggers on "explore repo", "look at this repo", or any GitHub URL with an exploratory question.

Context for managing dotfiles. Use when editing config files in $HOME that may be symlinks managed by stow.

Search Sourcegraph-indexed codebases for patterns, examples, and system understanding. Triggers on implementation questions, debugging, or "how does X work" queries.