warpdotdev/command-signatures

warpdotdev profile

Latest recorded source activity: August 4, 2026 at 23:01

SkillsMP catalog refreshed: October 17, 2026 at 00:09

skills collected: 5

GitHub stars: 6
GitHub forks: 10

Repository README

Repository README source: README.md

Read the source README

Expand full README

# command-signatures ## JSON Command Signatures The command signatures, a.k.a. "specs", are stored in the `./command-signatures/json`. All the specs in `./command-signatures/json/*.json` are hand-written. Those which are generated programmatically are in `./command-signatures/json/autogenerated/**/*.json`. Currently, we only autogenerate specs for PowerShell cmdlets. You can trigger this process with: ```sh cargo run --bin autogenerate_powershell ``` This must be rerun any time we change our autogeneration logic or Microsoft updates PowerShell's cmdlets. When making changes to this script, put the git hunks for the autogenerated specs into a separate commit to make PR review easier. ### Overriding Autogenerated Commands We often need to augment autogenerated specs with hand-written data. Hand-written data cannot be defined in an autogenerated file, but must live in a separate, persistent set of files. That is what `./command-signatures/json/overrides/**/*.json` is for. When running the autogeneration script, it'll check this dir and merge the data there into the generated result. You can _kind of_ think of the override process as a recursive object merge _a.la._ [Lodash's merge](https://lodash.com/docs/latest#merge), but this isn't totally accurate. Options' names are not object keys, and so a true recursive merge isn't the semantics we want. Furthermore, positional arguments are arrays and we need the ability to override at arbitrary positions, e.g. override argument 2 without needing to override 0 and 1. Options are therefore matched by the `OptionOverrides::name` field and positional arguments are matched by `ArgOverrides::index`, e.g. for PowerShell's `Set-Location` cmdlet: ```json { "args": [ { "index": 0, "template": ["folders"] } ], "options": [ { "name": "-Path", "args": { "index": 0, "template": ["folders"] } }, { "name": "-LiteralPath", "args": { "index": 0, "template": ["folders"] } } ] } ``` **Note:** Overrides for all fields on `fig_types::{Arg, Option}` may not be implemented yet. At the time of writing, _only_ `template` is supported. Others will need to be added as needed. ## License This project is licensed under the MIT License. See the LICENSE file for details. Many of the signatures were adapted from Fig (https://github.com/withfig/autocomplete), which is also licensed under the MIT License. Warp requires contributors to sign a contributor license agreement (CLA) before their contributions can be merged. You can read and sign our CLA at https://cla.warp.dev.

Loading the repository README…

Skills in this repository

Network & Computer Systems Administrators Software Developers Software Quality Assurance Analysts & Testers

3 occupation categories · 100% classified

skill

occupation

description

updated

review-pr-local

Software Quality Assurance Analysts & Testers

Repo-specific review guidance for command-signatures. Only the categories declared overridable by the core review-pr skill may be specialized here.

2026-08-04

update-command-spec-version

Software Developers

Update the warp-command-signatures dependency hash in warp to the latest commit from warpdotdev/command-signatures:main.

2026-07-13

implement-command-spec

Network & Computer Systems Administrators

Orchestrate and verify command-spec Oz runs for Linear tickets. Starts an implementation run using the add-command-spec skill, verifies all edited/created generators have meaningful screenshots, and retries with follow-up runs until validation passes. Use…

2026-04-27

test-local-warp

Network & Computer Systems Administrators

Test command-signatures changes locally by running Warp terminal against a local build of this crate. Use when the user wants to verify completion spec changes, generator changes, or other modifications in a real Warp session before merging.

2026-04-27

add-command-spec

Network & Computer Systems Administrators

Guide for adding new command completion specs to warp-command-signatures. Use when creating a new JSON spec for shell command completions, adding generators for dynamic suggestions, or extending existing command specs.

2026-04-03

Showing 5 of 5 collected skills.

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/warpdotdev/command-signatures.