Lap Platform Lap 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=<query>'

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

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

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=<query>'

Option B -- CLI:

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

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/<name> -o <name>.lap

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

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

Option C -- Download via CLI:

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

Option D -- 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

Setup

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

Source: Lap-Platform/LAP — distributed by TomeVault.