Lap

LAP CLI

Compile, search, and manage API specs for AI agents.

Command Resolution

Detect the available CLI binary once per session:

# Prefer global install, fall back to npx
if command -v lapsh &>/dev/null; then
  LAP_CMD="lapsh"
else
  LAP_CMD="npx @lap-platform/lapsh"
fi

Use $LAP_CMD (or the resolved form) for all commands below.

Agent Flow -- Consuming APIs

Use this flow when a user needs to find, download, or work with an API.

1. Discover

lapsh search <query> [--tag <tag>] [--sort relevance|popularity|date] [--limit <n>]

Search the LAP registry. Results show name, endpoint count, compression ratio, and a [skill] marker for installable skills.

# Find payment APIs sorted by popularity
lapsh search payment --sort popularity

# JSON output for scripting
lapsh search payment --json | jq '.results[] | select(.has_skill) | .name'

2. Acquire

Option A -- Install a skill (if [skill] marker present):

lapsh skill-install <name>
# Installs to ~/.claude/skills/<name>/

Option B -- Download the spec:

lapsh get <name> -o <name>.lap
lapsh get <name> --lean -o <name>.lean.lap

Option C -- Compile a local spec:

lapsh compile <spec-file> -o output.lap
lapsh compile <spec-file> -o output.lean.lap --lean

Supported formats: OpenAPI (YAML/JSON), GraphQL (SDL), AsyncAPI, Protobuf, Postman, Smithy. Format is auto-detected.

3. Use

Once you have a .lap file, read it directly -- LAP is designed for AI consumption. Key markers:

Publisher Flow -- Publishing APIs

Use this flow when a user wants to compile, package, and publish an API spec.

1. Authenticate

lapsh login
lapsh whoami        # verify

2. Compile

lapsh compile spec.yaml -o spec.lap
lapsh compile spec.yaml -o spec.lean.lap --lean

3. Generate Skill

# Basic skill (Layer 1 -- mechanical)
lapsh skill spec.yaml -o skills/ --no-ai

# AI-enhanced skill (Layer 2 -- requires claude CLI)
lapsh skill spec.yaml -o skills/ --ai

# Generate and install directly
lapsh skill spec.yaml --install

4. Publish

lapsh publish spec.yaml --provider stripe.com
lapsh publish spec.yaml --provider stripe.com --name charges --source-url https://...
lapsh publish spec.yaml --provider stripe.com --skill          # include skill
lapsh publish spec.yaml --provider stripe.com --skill --skill-ai  # with AI skill

5. Verify

lapsh search <name>   # confirm it appears in registry

6. Batch Operations

# Generate skills for all specs in a directory
lapsh skill-batch specs/ -o skills/

Quick Reference

Core Commands

Registry Commands

Skill Commands

Error Recovery

Environment Variables

References

• {baseDir}/references/agent-flow.md -- Extended agent workflow with examples
• {baseDir}/references/publisher-flow.md -- Extended publisher workflow with examples
• {baseDir}/references/command-reference.md -- Complete command reference with all flags