Cosin CLI

---

name: cosin

description: "Use this skill when an agent needs to operate the `cosin` CLI from the terminal. `cosin` accepts only relative paths, lists available skills through the `skills` subcommand, can call COS API paths directly, and can call `/cos/...` skills by turning them into x402 pay-and-call requests to the COS backend. This skill is for using the CLI, not for editing the cosin source code."

---

# Cosin CLI

Use `cosin` to call the COS API and COS-backed skills from the terminal.

What the CLI does

`cosin` now accepts only relative paths.

There are three request styles:

1. `skills`

Calls `https://skills.bankofuniverse.org/skills` directly and prints the upstream body directly.

2. Normal COS API paths such as `/v1/me`

These are sent directly to the COS API host.

3. Skill paths under `/cos/...`

These are converted internally into x402 pay-and-call requests:

Users should not pass absolute URLs to the CLI anymore.

Gather inputs

Collect these inputs before running the CLI:

Ask for the token if the user has not provided one. Treat it as sensitive.

Protect credentials

Run the CLI

Use one of these command shapes:

cosin --key <token> <METHOD> <PATH> [--json '<json>'] [--header 'Name: value'] [--base-url <url>]
cosin --key <token> agent [status|me] [--base-url <url>]
cosin --key <token> skills

Important flags:

Subcommand notes:

Supported paths

Built-in catalog

Use this to discover available skills:

cosin --key <token> skills

Expected upstream skills include:

Returns a random value from the Chainlink-based skill endpoint.

Returns the latest price for a supported token symbol.

Supported symbols for `/cos/crypto/price/:symbol`:

Direct COS API calls

Use normal API paths to call COS directly:

cosin --key <token> GET /v1/me
cosin --key <token> POST /v1/orders --json '{"symbol":"BTCUSDT"}'

Skill calls through `/cos/...`

Use `/cos/...` when you want to call a skill through COS:

cosin --key <token> GET /cos/crypto/chainlink/random
cosin --key <token> GET /cos/crypto/price/BTC

Internally, the CLI turns those into x402 pay-and-call requests to the COS backend.

Use the agent shortcut

Use `agent`, `agent status`, or `agent me` as a convenience alias for `GET /agent/me`.

cosin --key <token> agent
cosin --key <token> agent status
cosin --key <token> agent me

Do not combine `agent` with `--json` or custom headers.

Validate inputs before running

Read the output

Expect the CLI to:

Work locally in this repo

Use the local build when working inside this repository:

bun run build
./dist/index.js --key <token> agent
./dist/index.js --key <token> skills
./dist/index.js --key <token> GET /v1/me
./dist/index.js --key <token> GET /cos/crypto/chainlink/random

Use the published command shape locally when that is more convenient:

bun x cosin --key <token> agent
bun x cosin --key <token> skills
bun x cosin --key <token> GET /v1/me
bun x cosin --key <token> GET /cos/crypto/price/BTC