How ClaudeLines works

What a status line is

A Claude Code status line is a command configured in ~/.claude/settings.json. Claude Code sends session data to the command as JSON on standard input. The command writes text to standard output. Claude Code shows that text below the prompt.

The script runs on your computer with your user permissions. It can read files, write files, run programs, and make network requests if its code does so. See the Claude Code status line documentation.

What a listing contains

• The status line script.
• A captured ANSI preview supplied by the publisher.
• Name, description, tags, author wallet, and price.
• An audit summary, detected capabilities, and scanner flags.

The preview is stored text. The site does not run the script in your browser. A preview can be inaccurate, so inspect the source before installing.

Installing a status line

The Add button copies an instruction for Claude Code. It does not install anything by itself.

1. Get the script source. Free scripts use a GET request.
2. Paid scripts use POST /api/download and require payment.
3. Read the script.
4. Save it under ~/.claude/statuslines and make it executable.
5. Set statusLine.command in ~/.claude/settings.json.

slug="replace-with-listing-slug"
mkdir -p ~/.claude/statuslines
curl -fsSL "https://claudelines.com/api/statuslines/$slug/script" -o ~/.claude/statuslines/$slug
$EDITOR ~/.claude/statuslines/$slug
chmod +x ~/.claude/statuslines/$slug

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statuslines/replace-with-listing-slug"
  }
}

Checks on submitted scripts

1. The registration payment is verified.
2. An LLM reviews the submitted script.
3. A deterministic scanner checks for risky patterns such as remote downloads, shell execution, settings changes, scheduled jobs, credential access, and reverse shells.
4. A high severity scanner result rejects the submission.
5. An accepted script and its audit metadata are stored in the database. The stored script is the source returned to installers.

A rejected submission is not listed. The registration payment is not refunded because the audit has already run.

These checks do not prove that a script is safe. Read the script before running it.

Publishing

POST /api/register costs $0.15 through x402 or MPP. The request must include a slug, name, description, script, captured preview, price, and up to five tags. Scripts are limited to 32 KB. Set priceUsd to 0 for a free listing or a positive decimal USD amount for a paid listing.

The wallet that pays for registration becomes the listing owner. A verified X handle can be attached to that wallet through the identity endpoints.

Publish my Claude Code status line to https://claudelines.com. Read statusLine.command from ~/.claude/settings.json and read the script at that path. Show me the script before uploading it. Capture previewAnsi with COLUMNS=120. Read https://claudelines.com/llms.txt, then POST /api/register with the script, previewAnsi, slug, name, description, priceUsd, and tags.

Payments and accounting

• Free scripts are downloaded without payment.
• Paid downloads charge the price set by the publisher through x402 or MPP.
• Payment settles directly to the wallet that published the listing. ClaudeLines does not take a platform fee or hold the payment.
• The full purchase price is recorded in the listing revenue total.
• A purchase made by the publisher's own wallet does not increase installs or revenue.

API

Machine-readable details are available at /openapi.json. Agent instructions are available at /llms.txt.