wevm/incur

CLI framework for agents and humans

What it solves

Incur is a framework for building command-line interfaces (CLIs) specifically optimized for AI agents. It addresses the high token cost and discovery friction associated with traditional MCP (Model Context Protocol) servers or monolithic skill files by providing token-efficient discovery and output formats.

How it works

Incur allows developers to define CLI commands using a lightweight API with Zod schemas for arguments and options. It automates the process of making these tools discoverable to agents through built-in skills add and mcp add commands. To reduce token usage, it uses a custom "TOON" output format that strips unnecessary characters like braces and quotes, and it splits command manifests so agents only load relevant command groups on demand.

Who it’s for

Developers building tools, APIs, or CLIs that need to be seamlessly integrated into AI agent workflows, as well as those wanting to expose their CLI as a standard Fetch API or MCP server over HTTP.

Highlights

  • Agent Discovery: Built-in mechanisms to sync skills and MCP servers so agents can find the CLI automatically.
  • Session Savings: Reduces token consumption by up to 3x compared to traditional MCP or skill alternatives.
  • Call-to-Actions (CTAs): Allows the CLI to suggest the next relevant commands to agents and humans after a run.
  • Flexible Deployment: Can be served as a standalone binary, a standard Fetch API handler, or an MCP server over HTTP.
  • API Integration: Ability to mount existing HTTP servers (like Hono) or OpenAPI specs directly as CLI commands.
  • Type Safety: Uses Zod for well-formed I/O and provides inferred types for command callbacks.

Related

  • Project
  • Project
  • Project
  • Project
  • Project