Cosin CLI

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

What the CLI does

INLINECODE1 now accepts only relative paths.

There are three request styles:

1. 1. INLINECODE2

1. 2. Normal COS API paths such as INLINECODE4

1. 3. Skill paths under INLINECODE5

• - keeps the same request path
• builds the target URL from INLINECODE6
• sends that target URL to POST /agent/pay-and-call on the COS API host

Users should not pass absolute URLs to the CLI anymore.

Gather inputs

Collect these inputs before running the CLI:

• - A COS bearer token for INLINECODE8
• An HTTP method
• A relative path starting with INLINECODE9
• Optional JSON for INLINECODE10
• Optional repeatable headers for --header or INLINECODE12
• Optional --base-url override for normal COS API calls

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

Protect credentials

• - Treat the --key value as sensitive
• Do not print, commit, or hardcode the token
• Keep the token in the command line argument, not in repo files

Run the CLI

Use one of these command shapes:

CODEBLOCK0

Important flags:

• - --key <token> for the required bearer token
• INLINECODE16 for an optional JSON request body
• INLINECODE17 or -H 'Name: value' for repeatable custom headers
• INLINECODE19 to override the default COS API base URL for direct API calls
• INLINECODE20 or -v to print the installed CLI version
• INLINECODE22 or -h to print usage

Subcommand notes:

• - skills does not accept INLINECODE25
• INLINECODE26 does not accept custom headers
• INLINECODE27 does not accept INLINECODE28
• INLINECODE29 does not accept custom headers

Supported paths

Built-in catalog

Use this to discover available skills:

CODEBLOCK1

Expected upstream skills include:

• - INLINECODE30

• - INLINECODE31

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

• - INLINECODE33
• INLINECODE34
• INLINECODE35
• INLINECODE36
• INLINECODE37
• INLINECODE38
• INLINECODE39

Direct COS API calls

Use normal API paths to call COS directly:

CODEBLOCK2

Skill calls through /cos/...

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

CODEBLOCK3

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.

CODEBLOCK4

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

Validate inputs before running

• - Ensure the path starts with INLINECODE48
• Do not pass absolute URLs
• Use skills, not INLINECODE50
• Ensure --json is valid JSON
• Ensure headers use INLINECODE52
• For /cos/crypto/chainlink/random, only use INLINECODE54
• For /cos/crypto/price/:symbol, only use GET and only the supported symbols

Read the output

Expect the CLI to:

• - Print an HTTP status line for normal API requests, /cos/... skill calls, and INLINECODE58
• Print only the upstream body for the skills subcommand
• Pretty-print JSON response bodies
• Print <empty response body> for empty responses
• Return a non-zero exit code for unsuccessful HTTP responses or CLI argument errors

Work locally in this repo

Use the local build when working inside this repository:

CODEBLOCK5

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

CODEBLOCK6