{
  "id": "navi",
  "name": "navi",
  "homepage": "https://github.com/denisidoro/navi",
  "description": "An interactive cheatsheet tool for the command-line.",
  "executables": [
    "navi"
  ],
  "dotfiles": {
    "paths": [
      "~/.config/navi/config.yaml",
      "~/.local/share/navi/cheats/",
      "~/Library/Application Support/navi/cheats/"
    ],
    "secret": [],
    "side_effect": false
  },
  "commands": {
    "format": 1,
    "label": "Browse cheatsheets",
    "description": "Open navi's interactive cheatsheet finder. Finder overrides and subcommands (widget, repo, fn) are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": true,
      "short_bundles": false
    },
    "source": [
      {
        "id": "src",
        "kind": "help",
        "url": "https://github.com/denisidoro/navi/blob/master/src/config/cli.rs",
        "revision": "master (2026-10-27)",
        "evidence": "/// Colon-separated list of paths containing .cheat files\n#[arg(short, long)]\npub path: Option<String>,\n/// Instead of executing a snippet, prints it to stdout\n#[arg(long)]\npub print: bool,\n/// Returns the best match\n#[arg(long)]\npub best_match: bool,\n/// Searches for cheatsheets using the tldr-pages repository\n#[arg(long)]\npub tldr: Option<String>,\n/// [Experimental] Comma-separated list that acts as filter for tags. Parts starting with ! represent negation\n#[arg(long)]\npub tag_rules: Option<String>,\n/// Searches for cheatsheets using the cheat.sh repository\n#[arg(long)]\npub cheatsh: Option<String>,\n/// Prepopulates the search field\n#[arg(short, long, allow_hyphen_values = true)]\npub query: Option<String>,\nResulting flags: -p, --path <PATH>   -q, --query <QUERY>   --print   --best-match   --tldr <TLDR>   --cheatsh <CHEATSH>   --tag-rules <TAG_RULES>"
      }
    ],
    "field": [
      {
        "id": "path",
        "label": "Cheat paths",
        "description": "Colon-separated list of paths containing .cheat files.",
        "type": "string",
        "option": [
          "--path",
          "-p"
        ],
        "sources": [
          "src"
        ]
      },
      {
        "id": "query",
        "label": "Initial query",
        "type": "string",
        "option": [
          "--query",
          "-q"
        ],
        "sources": [
          "src"
        ]
      },
      {
        "id": "print",
        "label": "Print snippet instead of running",
        "type": "boolean",
        "option": [
          "--print"
        ],
        "sources": [
          "src"
        ]
      },
      {
        "id": "best_match",
        "label": "Return best match",
        "type": "boolean",
        "option": [
          "--best-match"
        ],
        "sources": [
          "src"
        ]
      },
      {
        "id": "tldr",
        "label": "Search tldr pages",
        "type": "string",
        "option": [
          "--tldr"
        ],
        "sources": [
          "src"
        ]
      },
      {
        "id": "cheatsh",
        "label": "Search cheat.sh",
        "type": "string",
        "option": [
          "--cheatsh"
        ],
        "sources": [
          "src"
        ]
      },
      {
        "id": "tag_rules",
        "label": "Tag rules",
        "description": "Comma-separated tags; prefix with ! to negate. Experimental.",
        "type": "string",
        "option": [
          "--tag-rules"
        ],
        "sources": [
          "src"
        ]
      }
    ],
    "task": [
      {
        "id": "search",
        "label": "Search with a query",
        "fields": [
          "query",
          "print",
          "best_match"
        ],
        "required": [
          "query"
        ]
      },
      {
        "id": "tldr",
        "label": "Search tldr pages",
        "fields": [
          "tldr",
          "print"
        ],
        "required": [
          "tldr"
        ]
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "query",
          "print",
          "best_match",
          "path"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "tldr",
          "cheatsh",
          "tag_rules"
        ]
      }
    ]
  }
}
