Lap

LAP CLI

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

Command Resolution

IMPORTANT: Always use curl for registry operations (search, get, check). Do NOT use npx for these -- it downloads the package every time and takes minutes. curl is instant.

# Search the registry
curl -s 'https://registry.lap.sh/v1/search?q='

# Download a spec
curl -sH 'Accept: text/lap' https://registry.lap.sh/v1/apis/ -o .lap

# Get API metadata (version, endpoint count)
curl -sH 'Accept: application/json' https://registry.lap.sh/v1/apis/

Only use the CLI (lapsh or npx @lap-platform/lapsh) for operations that require it: compile, publish, skill-install, init.

---

Agent Flow -- Consuming APIs

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

1. Discover

Option A -- curl (fastest):

curl -s 'https://registry.lap.sh/v1/search?q='

Option B -- CLI:

lapsh search  [--tag ] [--sort relevance|popularity|date] [--limit ]

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

2. Acquire

Option A -- curl (fastest):

curl -sH 'Accept: text/lap' https://registry.lap.sh/v1/apis/ -o .lap

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

lapsh skill-install  --target codex
# Installs to ~/.codex/skills//

Option C -- Download via CLI:

lapsh get  -o .lap
lapsh get  --lean -o .lean.lap

Option D -- Compile a local spec:

lapsh compile  -o output.lap
lapsh compile  -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:

| Marker | Meaning | |--------|---------| | @api | API name, version, base URL | | @endpoint | HTTP method + path | | @param | Parameter (query, path, header) | | @body | Request body schema | | @response | Response status + schema | | @required | Required fields | | @error | Error response |

---

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    # 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

| Command | Description | |---------|-------------| | compile | Compile API spec to LAP format |

Registry Commands

| Command | Description | |---------|-------------| | search | Search the LAP registry | | get | Download a LAP spec | | publish | Compile and publish to registry | | login | Authenticate via GitHub OAuth | | logout | Revoke token | | whoami | Show authenticated user |

Setup

| Command | Description | |---------|-------------| | init --target codex | Set up LAP for Codex CLI | | init --target cursor | Set up LAP for Cursor |

Skill Commands

| Command | Description | |---------|-------------| | skill | Generate Codex CLI skill from spec | | skill-batch | Batch generate skills | | skill-install --target codex | Install skill from registry to Codex CLI |

---

Error Recovery

| Problem | Fix | |---------|-----| | command not found: lapsh | npm install -g @lap-platform/lapsh or use npx @lap-platform/lapsh | | Not authenticated | Run lapsh login first | | Format detection failed | Pass -f openapi (or graphql, asyncapi, protobuf, postman, smithy) | | 403 Forbidden on get | Spec may be private or registry may block without User-Agent -- update lapsh | | YAML parse error | Check spec is valid YAML/JSON -- use a linter first | | Layer 2 requires claude | Install Claude CLI or use --no-ai for Layer 1 skills | | Provider required | publish needs --provider (e.g., --provider stripe.com) |

---

Environment Variables

| Variable | Purpose | Default | |----------|---------|---------| | LAP_REGISTRY | Override registry URL | https://registry.lap.sh |

---

References

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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Lap-Platform
• Source: Lap-Platform/LAP
• License: Apache-2.0
• Homepage: https://lap.sh/

Install and usage instructions live in the source repository linked above.