- name
- lap
- description
- LAP CLI -- compile, search, and manage API specs for AI agents. Use when working with API specifications (OpenAPI, GraphQL, AsyncAPI, Protobuf, Postman), compiling specs to LAP format, searching the LAP registry, generating skills from API specs, or publishing APIs. Commands: compile, search, get, skill, skill-install, skill-batch, publish, login, logout, whoami.
- user-invocable
- true
- version
- 1.0.0
- metadata
- openclaw
- emoji
- \⚡
- requires
- anyBins
- ["npx", "lapsh"]
- install
- kind
- node
- package
- @lap-platform/lapsh
- bins
- ["lapsh"]
- label
- Install LAP CLI (npm)
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"
fiUse $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.lapOption C -- Compile a local spec:
lapsh compile <spec-file> -o output.lap
lapsh compile <spec-file> -o output.lean.lap --leanSupported 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 # verify2. Compile
lapsh compile spec.yaml -o spec.lap
lapsh compile spec.yaml -o spec.lean.lap --lean3. 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 --install4. 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 skill5. Verify
lapsh search <name> # confirm it appears in registry6. Batch Operations
# Generate skills for all specs in a directory
lapsh skill-batch specs/ -o skills/
Quick Reference
Core Commands
| Command | Description |
|---|---|
compile <spec> | Compile API spec to LAP format |
Registry Commands
| Command | Description |
|---|---|
search <query> | Search the LAP registry |
get <name> | Download a LAP spec |
publish <spec> | Compile and publish to registry |
login | Authenticate via GitHub OAuth |
logout | Revoke token |
whoami | Show authenticated user |
Skill Commands
| Command | Description |
|---|---|
skill <spec> | Generate Claude Code skill from spec |
skill-batch <dir> | Batch generate skills |
skill-install <name> | Install skill from registry |
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 <domain> (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 -- 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