peaqOS AI

peaqOS ships one curated agent skill — peaqos — that turns your AI agent into a peaqOS onboarding co-pilot. It’s a skill.md-spec skill with first-class adapters for Claude Code, Cursor, and Windsurf, plus a manual upload path for any other runtime that reads the standard. Under the hood it drives the peaqos Python CLI — anything you can do at the terminal, the skill can do for you with the right questions asked first.

What the skill does

Trigger it in your agent (/peaqos in Claude Code, or just describe what you want elsewhere) and it picks the right mode based on what you ask:

Mode	When it kicks in
Demo	First-time tour on agung testnet — full onboarding in ~15 minutes with explanations at every step.
Real onboarding	Asks five questions about your machine and deployment, recommends a self-managed or operator-managed setup, then runs the CLI to activate the machine and submit the first event.
Fleet management	Pulls MCR scores for an operator’s fleet, surfaces machines with low or no rating, submits heartbeat events.
Machine Markets (Scale)	Onboards a machine to the orchestrator, pairs an agent with a delegation policy, runs market search, places an order, and confirms or disputes delivery. Drives `peaqos scale ...` end-to-end.
Troubleshooting	Diagnoses common failures — funding, activation, MCR lag, key mismatches — and walks you through the fix.

The skill adapts its tone to your background: concise for developers, plain English with narrated steps for non-technical operators.

Install

Two pieces. The CLI does the actual work; the skill is the orchestration layer your agent loads.

1. Install the CLI

python3 -m venv .peaqos-env
source .peaqos-env/bin/activate
pip install 'peaq-os-cli[ows]<0.0.8' 'peaq-os-sdk<0.6.0'
peaqos --version

Pin the CLI below 0.0.8 for now. The peaqos skill (@peaqos/skills 0.1.0) was last aligned with CLI 0.0.6 and drives the Tokenomics 1.0 peaqos activate --doc-url ... --data-api ... flow. CLI 0.0.8 (2026-09-04) replaced that command with the one-transaction Economics 2.0 activation and rejects those flags, so the skill’s onboarding mode breaks against a fresh pip install peaq-os-cli. The pin comes off when the skill updates. Pin the SDK as well: peaq-os-cli<0.0.8 alone resolves to CLI 0.0.7 with SDK 0.7.0, and peaqos monetize then crashes with a TypeError in MonetizationConfig. CLI 0.0.7 with SDK 0.5.0 needs Python 3.11 or newer; 0.0.8 needs 3.12.

2. Add the skill to your agent

# Auto-detect (Claude Code, Cursor, or Windsurf)
npx skills add peaqnetwork/peaq-os-skills

# Or target a specific runtime
npx skills add peaqnetwork/peaq-os-skills --agent claude-code
npx skills add peaqnetwork/peaq-os-skills --agent cursor
npx skills add peaqnetwork/peaq-os-skills --agent windsurf

The installer ships adapters for Claude Code, Cursor, and Windsurf, auto-detecting the agent it finds on disk (or prompting if multiple are installed). Invoke /peaqos (Claude Code) or just describe what you want (e.g. “onboard my machine to peaqOS”) in Cursor or Windsurf. For ChatGPT, Claude Projects, custom GPTs, or anywhere you can’t run a local CLI, clone the repo and upload AGENT-PROMPT.md as the system prompt with knowledge/ and GUIDE.md as knowledge sources:

git clone https://github.com/peaqnetwork/peaq-os-skills

LLM context files

Separate from the curated skill, Mintlify auto-generates machine-readable bundles of these docs. Point any agent at one of:

File	URL	Use when
`llms.txt`	https://docs.peaq.xyz/llms.txt	Model has a modest context window or you want a compact index with links
`llms-full.txt`	https://docs.peaq.xyz/llms-full.txt	Model has a large context window and you want the full docs inline
`skill.md`	https://docs.peaq.xyz/skill.md	Agent needs a doc-derived capabilities spec rather than prose docs

These are doc context, not a substitute for the curated peaqos skill — that one knows the onboarding flow, decision tree, and recovery paths; the auto-generated bundle just knows what’s on the page.

Editor setup (docs context)

Wire the peaq docs into your editor of choice. Independent of the peaqos skill — useful any time you want the agent to ground answers in current docs.

Cursor

Open Cursor Settings → Features → Docs, click Add new doc, and paste:

https://docs.peaq.xyz/llms-full.txt

Reference peaq in chat with @docs → peaq.

Windsurf

Windsurf has no persistent docs store. Paste into Cascade (Cmd+L) per chat:

@docs:https://docs.peaq.xyz/llms-full.txt

Claude Code

Add the Mintlify-hosted MCP server to .mcp.json:

{
  "mcpServers": {
    "peaq-docs": { "url": "https://docs.peaq.xyz/mcp" }
  }
}

Or one-shot install with the Mintlify CLI:

npx @mintlify/mcp add docs.peaq.xyz

Claude Desktop / ChatGPT / any MCP client

Same MCP URL: https://docs.peaq.xyz/mcp. For custom GPTs or Claude Projects, upload llms-full.txt as a knowledge source.

peaqChain AI integrations

Chain-level prompting tips, Cursor Projects, peaq SDK prompt patterns.

SDK reference

The ground truth the skill calls into via the CLI.

Welcome

Get Started

Concepts

Functions

Guides

What the skill does

Install

1. Install the CLI

2. Add the skill to your agent

LLM context files

Editor setup (docs context)

See also

peaqChain AI integrations

SDK reference

​What the skill does

​Install

​1. Install the CLI

​2. Add the skill to your agent

​LLM context files

​Editor setup (docs context)

​See also

peaqChain AI integrations

SDK reference

What the skill does

Install

1. Install the CLI

2. Add the skill to your agent

LLM context files

Editor setup (docs context)

See also