agentsclimarketplace

Pixee api

Skill pixee/pixee-cli/skills/pixee-api

Send authenticated requests to any Pixee REST API endpoint.From its SKILL.md

Install
npx -y skills add pixee/pixee-cli --skill pixee-api

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.

SKILL.md

3.4 KB, as published. Nobody here has run it

pixee api

PREREQUISITE: Read ../pixee-shared/SKILL.md for global flags, exit codes, and error handling. Those conventions apply to every command in this skill. See ../pixee-auth/SKILL.md if authentication needs to be configured.

The escape-hatch subcommand. pixee api sends authenticated HTTP requests to any Pixee REST API endpoint, modeled on gh api. Use it when a dedicated subcommand does not yet exist, or when an agent needs to compose multi-step operations directly against the API.

HAL discovery

The Pixee API is a HAL (Hypertext Application Language) API: every response contains _links that name the related resources. Start at /api/v1 and follow _links to reach every other endpoint. Do not hardcode paths beyond the root.

# Inspect the root to find the available resources
pixee api /api/v1

# Follow a link — here, the "repositories" link on the root
pixee api /api/v1/repositories --paginate

# Each resource has its own _links; follow them to related resources
pixee api /api/v1/repositories/<id>

Conventions

pixee api closely mirrors gh api:

  • Default method is GET. pixee api switches to POST automatically when any -f / -F field is supplied. Override explicitly with --method <VERB>.
  • -f key=value adds a raw string field.
  • -F key=value adds a typed field, converting true/false to booleans and numeric strings to numbers.
  • --input <file> reads a pre-constructed JSON body from a file. Use --input - to read from stdin.
  • Output is raw JSON. pixee does not embed a jq implementation; pipe to jq externally for filtering or transformation.

Pagination

By default, paginated endpoints return only the first page. Add --paginate to let pixee walk the collection automatically:

pixee api /api/v1/repositories --paginate

With --paginate, pixee follows _links.next until it is absent, merges each page's _embedded.items array, and emits a single flat JSON array. The HAL envelope (_links, page, total) is stripped from the output.

This is pagination-strategy-agnostic: the CLI does not construct page-number query parameters itself, so if the API migrates to a different strategy the same --paginate flag continues to work.

Examples

# POST a workflow with typed fields (auto-switches to POST because fields are present)
pixee api /api/v1/repositories/<id>/workflows \
  -f event=new-scan \
  -F branch=main \
  -f action=none

# Or submit a pre-constructed body
pixee api /api/v1/repositories/<id>/workflows --input workflow.json

# Filter a paginated response externally with jq
pixee api /api/v1/repositories --paginate | jq '.[] | .full_name'

Best practices

  • Always use --paginate to collect a full collection; do not hand-roll page-number query parameters.
  • Discover endpoints by following _links from /api/v1; do not inject the OpenAPI specification into agent context.
  • Prefer dedicated subcommands (pixee repo list, pixee workflow list) when they exist — they encode best practices on top of pixee api. Use pixee api as the escape hatch for operations that do not yet have a subcommand.

Keep looking

Skills are one crate of 613,872. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.