CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl/api

Find and call Tessl API endpoints token-efficiently. Fires whenever an agent needs a Tessl REST API endpoint — to discover which endpoint does something, learn its path/parameters/request-body/response shape, or actually call it via `tessl api`. Searches and renders just the one endpoint you need instead of loading the whole openapi.json into context.

87

1.91x
Quality

94%

Does it follow best practices?

Impact

94%

1.91x

Average score across 2 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

Overview
Quality
Evals
Security
Files

criteria.jsonevals/scenario-1/

{
  "context": "The agent must use the tessl_api_discover.py helper to search for and inspect an install-related endpoint, using the proper search-then-show workflow, and then use --expand to reveal the full union schema details. The output file install-source-variants.md must document the commands run and the variant shapes found.",
  "type": "weighted_checklist",
  "checklist": [
    {
      "name": "Uses search first",
      "description": "The documented workflow shows a `search` command (e.g. `python3 scripts/tessl_api_discover.py search ...`) was run before `show`, establishing the correct discovery order",
      "max_score": 10
    },
    {
      "name": "Uses show command",
      "description": "The documented workflow includes a `show` command (e.g. `python3 scripts/tessl_api_discover.py show ...`) targeting the install/policy endpoint",
      "max_score": 10
    },
    {
      "name": "Uses --expand flag",
      "description": "The documented workflow shows `--expand` was passed to a `show` command to fully inline the union schema",
      "max_score": 15
    },
    {
      "name": "Uses --status flag",
      "description": "The documented workflow includes `--status 200` (or another status code) on a `show` invocation to limit output to a single response shape",
      "max_score": 10
    },
    {
      "name": "Multiple variant shapes listed",
      "description": "The output document lists at least two distinct install source variant types (e.g. registry, git, file) rather than a single collapsed line",
      "max_score": 20
    },
    {
      "name": "Required fields per variant",
      "description": "For each listed variant, the document identifies which fields are required (not just the variant name)",
      "max_score": 15
    },
    {
      "name": "Uses helper script not raw spec",
      "description": "Commands shown use `python3 scripts/tessl_api_discover.py` — does NOT reference reading `openapi.json` directly",
      "max_score": 10
    },
    {
      "name": "No Authorization header",
      "description": "The documented commands and any example API calls do NOT manually set an Authorization header",
      "max_score": 10
    }
  ]
}

README.md

tile.json