fallow.tools

{
  "name": "find_docs",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search the Fallow documentation. Returns the best matching pages and sections, each with a title, a URL and a short snippet.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Keywords or a question, for example `unused exports` or `runtime coverage`.",
        "minLength": 1,
        "maxLength": 200
      },
      "limit": {
        "type": "integer",
        "description": "The maximum number of results. Default 5.",
        "minimum": 1,
        "maximum": 10
      }
    },
    "required": [
      "query"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_quickstart",
  "kind": "answer",
  "impl": "imperative",
  "description": "Return the Fallow quickstart as Markdown: how to run the free static analysis with npx fallow, and the next steps.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "search_docs",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search the Fallow documentation. Returns the best matching pages, sections, CLI flags and config keys, with a URL and a short snippet for each.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Keywords or a question, for example `unused exports` or `--changed-since`.",
        "minLength": 1,
        "maxLength": 200
      },
      "limit": {
        "type": "integer",
        "description": "The maximum number of results. Default 8.",
        "minimum": 1,
        "maximum": 25
      }
    },
    "required": [
      "query"
    ],
    "additionalProperties": false
  },
  "page": "/docs/"
}

{
  "name": "read_page",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read one page of the Fallow documentation as plain Markdown with no components, the same text as the page .md URL. The text starts with the title, the description and the page URL.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "slug": {
        "type": "string",
        "description": "The docs page: a slug such as `cli/health`, a path such as `/docs/cli/health/`, or a fallow.tools docs URL. Use `list_pages` or `search_docs` to find it.",
        "minLength": 1
      }
    },
    "required": [
      "slug"
    ],
    "additionalProperties": false
  },
  "page": "/docs/"
}

{
  "name": "list_pages",
  "kind": "answer",
  "impl": "imperative",
  "description": "List the pages of the Fallow documentation in navigation order, with the tab, group, description and URL of each page.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "tab": {
        "type": "string",
        "description": "Only pages in this navigation tab, for example `Documentation` or `CLI reference`."
      },
      "group": {
        "type": "string",
        "description": "Only pages in this sidebar group, for example `Configuration`."
      }
    },
    "additionalProperties": false
  },
  "page": "/docs/"
}

{
  "name": "grep_docs",
  "kind": "answer",
  "impl": "imperative",
  "description": "Find exact text or a regular expression in the Markdown of every Fallow docs page. Returns the page slug, the line number, the line and the URL of the nearest section for each match. Use it for exact strings such as error codes and config keys; use search_docs for questions.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "pattern": {
        "type": "string",
        "description": "The text to find. With `regex` true, a JavaScript regular expression.",
        "minLength": 1,
        "maxLength": 200
      },
      "regex": {
        "type": "boolean",
        "description": "Read `pattern` as a regular expression."
      },
      "case_sensitive": {
        "type": "boolean",
        "description": "Match upper and lower case exactly."
      },
      "path": {
        "type": "string",
        "description": "Only pages whose slug starts with this prefix, for example `cli/`.",
        "maxLength": 100
      },
      "max_results": {
        "type": "integer",
        "description": "The maximum number of matched lines. Default 50.",
        "minimum": 1,
        "maximum": 200
      }
    },
    "required": [
      "pattern"
    ],
    "additionalProperties": false
  },
  "page": "/docs/"
}

{
  "name": "get_cli_flag",
  "kind": "answer",
  "impl": "imperative",
  "description": "Look up a fallow CLI flag, for example `--changed-since` or `production`. Returns the flag documentation and the page that owns it.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "flag": {
        "type": "string",
        "description": "The flag, with or without the leading dashes.",
        "minLength": 1,
        "maxLength": 200
      }
    },
    "required": [
      "flag"
    ],
    "additionalProperties": false
  },
  "page": "/docs/"
}

{
  "name": "read_skill",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read the fallow agent skill as Markdown. The skill tells a coding agent when and how to run fallow.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/docs/"
}

{
  "name": "submit_feedback",
  "kind": "transact",
  "impl": "imperative",
  "description": "Report a docs page that is incorrect, outdated, unclear or incomplete. This tool sends nothing and stores nothing: it returns a link to a pre-filled GitHub issue in fallow-rs/docs. Give the link to the reader, who can check and send the issue.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "feedback": {
        "type": "string",
        "description": "What is wrong or missing, and what the page must say.",
        "minLength": 1,
        "maxLength": 2000
      },
      "page": {
        "type": "string",
        "description": "Optional slug or URL of the page. Default: the open page.",
        "maxLength": 512
      },
      "kind": {
        "type": "string",
        "description": "The kind of problem.",
        "enum": [
          "incorrect",
          "outdated",
          "unclear",
          "missing",
          "other"
        ]
      }
    },
    "required": [
      "feedback"
    ],
    "additionalProperties": false
  },
  "page": "/docs/"
}

{
  "name": "navigate_page",
  "kind": "act",
  "impl": "imperative",
  "description": "Open a page of the Fallow documentation in this tab, optionally at a section anchor. Use it to show the reader a page.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "slug": {
        "type": "string",
        "description": "The docs page: a slug such as `cli/health`, a path such as `/docs/cli/health/`, or a fallow.tools docs URL. Use `list_pages` or `search_docs` to find it.",
        "minLength": 1
      },
      "anchor": {
        "type": "string",
        "description": "An optional section anchor on the page, without `#`.",
        "pattern": "^[A-Za-z0-9_-]+$"
      }
    },
    "required": [
      "slug"
    ],
    "additionalProperties": false
  },
  "page": "/docs/"
}

{
  "name": "get_current_page",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get the docs page that is open in this tab: its slug, title, description, URL and section headings.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/docs/"
}