modules/home/programs/cli-agents/shared/skills/meta/pi-agent/SKILL.md
Spawn the pi coding agent with a specific model/provider. Use when asked to run pi with a particular model, switch pi's model, use DeepSeek V4 Flash/Pro in pi, or look up pi's --model/--provider/--models CLI flags and thinking-level shorthand.
npx skillsauth add not-matthias/dotfiles-nix pi-agentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
pi (the pi-mono coding agent) selects its model from CLI flags. Args without a
flag are treated as the initial prompt, so the model must be passed explicitly.
| Flag | Purpose |
|------|---------|
| --provider <name> | Provider id (default: google) |
| --model <pattern> | Model id/pattern. Supports provider/id and :<thinking> suffix |
| --models <patterns> | Comma-separated patterns for Ctrl+P in-session cycling (globs + fuzzy: anthropic/*, *sonnet*) |
| --thinking <level> | off, minimal, low, medium, high, xhigh |
| --list-models [search] | List available models (fuzzy filter optional) |
Each value flag needs an argument — pi --model alone errors as "Unknown option".
pi --provider openai --model gpt-4o-mini "refactor this" # provider + bare id
pi --model openai/gpt-4o "refactor this" # provider/id prefix
pi --model sonnet:high "solve this" # model + thinking shorthand
Via DeepSeek's native API (DEEPSEEK_API_KEY, api.deepseek.com):
pi --provider deepseek --model deepseek-v4-flash "your prompt"
pi --provider deepseek --model deepseek-v4-pro "your prompt"
pi --provider deepseek --models deepseek-v4-flash,deepseek-v4-pro
pi --list-models deepseek (needs the
relevant API key in the environment).-p/--print for non-interactive runs, e.g.
pi --provider deepseek --model deepseek-v4-pro -p "summarize README".documentation
Save notes, journal entries, and research to the personal-notes Obsidian vault (personal-vault-v2). Use when the user asks to 'save note', 'save to notes', 'write to personal notes', 'save to daily notes', 'note this down', or wants to persist findings/analysis to their personal vault.
documentation
Use whenever the user asks to address, fix, resolve, review, or respond to pull-request comments or review feedback.
development
Apply Not Matthias's Rust-first personal coding style. Use whenever the user explicitly asks to apply or review their code style, make Rust match their preferences, perform a style pass, or simplify/refactor according to their conventions. Inspect only task-touched code, honor local project conventions first, and make only safe opt-out style edits.
development
Guide for writing ast-grep rules to perform structural code search and analysis. Use when users need to search codebases using Abstract Syntax Tree (AST) patterns, find specific code structures, or perform complex code queries that go beyond simple text search. This skill should be used when users ask to search for code patterns, find specific language constructs, or locate code with particular structural characteristics.