incur 0.0.0 → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,141 @@
+# incur
+
+Simple CLI framework for agents and humans.
+
+## Quickprompt
+
+Prompt your agent:
+
+```sh
+# Skills (recommended — lighter on tokens)
+> "Run `npx incur skills add`, then show me what I can do with incur."
+
+# MCP
+> "Run `npx incur mcp add`, then show me what I can do with incur."
+```
+
+## Install
+
+```bash
+npm i incur
+```
+
+```bash
+pnpm i incur
+```
+
+```bash
+bun i incur
+```
+
+## Usage
+
+### Single-command CLI
+
+```ts
+import { Cli, z } from 'incur'
+
+Cli.create('greet', {
+  description: 'A greeting CLI',
+  args: z.object({
+    name: z.string().describe('Name to greet'),
+  }),
+  run({ args }) {
+    return { message: `hello ${args.name}` }
+  },
+}).serve()
+```
+
+```sh
+$ greet world
+# → message: hello world
+```
+
+### Multi-command CLI
+
+```ts
+import { Cli, z } from 'incur'
+
+Cli.create('my-cli', {
+  description: 'My CLI',
+})
+  .command('status', {
+    description: 'Show repo status',
+    run() {
+      return { clean: true }
+    },
+  })
+  .command('install', {
+    description: 'Install a package',
+    args: z.object({
+      package: z.string().optional().describe('Package name'),
+    }),
+    options: z.object({
+      saveDev: z.boolean().optional().describe('Save as dev dependency'),
+    }),
+    alias: { saveDev: 'D' },
+    run({ args }) {
+      return { added: 1, packages: 451 }
+    },
+  })
+  .serve()
+```
+
+```sh
+$ my-cli status
+# → clean: true
+
+$ my-cli install express -D
+# → added: 1
+# → packages: 451
+```
+
+### Sub-command CLI
+
+```ts
+const cli = Cli.create('my-cli', { description: 'My CLI' })
+
+// Create a `pr` group.
+const pr = Cli.create('pr', { description: 'Pull request commands' }).command('list', {
+  description: 'List pull requests',
+  options: z.object({
+    state: z.enum(['open', 'closed', 'all']).default('open'),
+  }),
+  run({ options }) {
+    return { prs: [], state: options.state }
+  },
+})
+
+cli
+  .command(pr) // Link the `pr` group.
+  .serve()
+```
+
+```sh
+$ my-cli pr list --state closed
+# → prs: (empty)
+# → state: closed
+```
+
+### Agent discovery
+
+Every incur CLI gets built-in agent discovery:
+
+```sh
+# Auto-generate and install agent skill files (recommended — lighter on tokens)
+my-cli skills add
+
+# Register as an MCP server for your agents
+my-cli mcp add
+
+# Output machine-readable manifest
+my-cli --llms
+```
+
+## API Reference
+
+> TODO
+
+## License
+
+MIT