not-matthias/pi-agent
modules/home/programs/cli-agents/shared/skills/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.
$ install --global
skillsauthnpx skillsauth add not-matthias/dotfiles-nix pi-agentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 3, 2026, 3:10 AM28.6s1 file scanned
SKILL.md
- name:
- pi-agent
- description:
- 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.
Spawning pi with a specific model
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.
CLI flags
| 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".
Equivalent ways to pick a model
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
DeepSeek V4 Flash & Pro
Two routes. Pick based on which API key is in pi's env file
(secrets/pi-mono-env.age → ~/.pi):
Via OpenRouter — the configured provider in this dotfiles (OPENROUTER_API_KEY)
pi --provider openrouter --model deepseek/deepseek-v4-flash "your prompt"
pi --provider openrouter --model deepseek/deepseek-v4-pro "your prompt"
# Free Flash tier:
pi --provider openrouter --model "deepseek/deepseek-v4-flash:free" "your prompt"
Use
--provider openrouterexplicitly.--model deepseek/deepseek-v4-flashalone parsesdeepseek/as the native deepseek provider, not OpenRouter.
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"
Cycle between Flash and Pro in-session (Ctrl+P)
pi --provider openrouter --models deepseek/deepseek-v4-flash,deepseek/deepseek-v4-pro
Notes
- Verify availability and exact ids with
pi --list-models deepseek(needs the relevant API key in the environment). - Combine with
-p/--printfor non-interactive runs, e.g.pi --provider openrouter --model deepseek/deepseek-v4-pro -p "summarize README".
Related Skills
not-matthias/zoxide-nav
development
VerifiedTrustedCommunity
Navigate to directories using zoxide (frecency-based directory jumper). Use when the user says "go to", "navigate to", "cd to", "jump to" a project or directory by nickname/partial name (e.g. "go to my dotfiles", "jump to dot").
9SKILL.mdUpdated Apr 20, 2026
not-matthias/zellij
tools
VerifiedTrustedCommunity
Use when manipulating Zellij sessions, creating tabs or panes, sending commands to panes, capturing output, or looking up Zellij CLI commands for terminal multiplexer operations
9SKILL.mdUpdated Apr 20, 2026
not-matthias/writing-style
development
VerifiedTrustedCommunity
Emulates not-matthias's technical blog writing style. Use when writing blog posts, technical articles, README content, or any long-form technical prose. Produces investigation-driven, first-person narratives with dry humor, practical code examples, and concrete takeaways.
9SKILL.mdUpdated Apr 20, 2026
not-matthias/worktree-parallel
development
VerifiedTrustedCommunity
Create and manage Git worktrees for parallel feature development. Use when user wants to work on multiple features simultaneously or needs isolated development environments.
9SKILL.mdUpdated Apr 20, 2026