CLI Reference¶
wnp is the Wanepia command-line interface. It provides full access to the API from your terminal.
Installation¶
# Download latest release
curl -Lo wnp https://github.com/wanepia/wnp/releases/latest/download/wnp-$(uname -s)-$(uname -m)
chmod +x wnp && sudo mv wnp /usr/local/bin/
Global flags¶
| Flag | Description |
|---|---|
--url <url> |
API base URL (overrides config) |
--token <key> |
API key (overrides config) |
--json |
Output raw JSON instead of the table view |
Configuration¶
Config is stored in ~/.config/wnp/config.yaml.
wnp status¶
wnp status show¶
Fleet health summary — entity counts by status and a full entity list.
wnp status transitions¶
Recent state-change events across all entities.
wnp blueprints (alias: bp)¶
wnp blueprints list¶
List all blueprints.
wnp blueprints get <slug>¶
Show a blueprint and its fields.
wnp blueprints create¶
Create a new blueprint.
| Flag | Required | Description |
|---|---|---|
--slug |
Yes | URL-safe identifier |
--name |
Yes | Display name |
--desc |
No | Description |
wnp entities (aliases: ent, e)¶
wnp entities list <blueprint>¶
List all entities for a blueprint.
wnp entities get <blueprint> <slug>¶
Show an entity and its field values.
wnp entities create <blueprint>¶
Create an entity under a blueprint.
wnp entities create api \
--slug payments-api \
--name "Payments API" \
--field team=platform \
--field repo_url=https://github.com/acme/payments
| Flag | Required | Description |
|---|---|---|
--slug |
Yes | URL-safe identifier |
--name |
Yes | Display name |
--field key=value |
No | Custom field (repeatable) |
wnp entities update <blueprint> <slug>¶
Update an entity's name or field values.
wnp entities delete <blueprint> <slug>¶
Delete an entity and all its checks.
wnp checks (alias: chk)¶
wnp checks list¶
List all checks.
IDs are abbreviated for readability. Use --json for full UUIDs, or pass any unambiguous prefix.
wnp checks get <id>¶
Show a check's configuration.
wnp checks create¶
Create a health check.
# HTTP check
wnp checks create \
--entity <entity-id> \
--type http \
--url https://api.example.com/health \
--interval 60 \
--status 200 \
--threshold 3
# Push check (agent posts results — no URL needed)
wnp checks create \
--entity <entity-id> \
--type push \
--name "Postgres reachability" \
--interval 60 \
--threshold 1
| Flag | Default | Description |
|---|---|---|
--entity |
— | Entity ID (required) |
--type |
http |
Check type: http, tcp, tls, dns, push |
--url |
— | Target URL or host:port (required for non-push types) |
--name |
"" |
Display name for the check |
--interval |
60 |
Poll interval in seconds |
--timeout |
5000 |
Timeout in milliseconds |
--status |
0 |
Expected HTTP status code (HTTP only) |
--body |
"" |
Required response body substring (HTTP only) |
--threshold |
3 |
Consecutive failures before state change |
For push checks, set --threshold 1 — agents run infrequently so a single failure should fire immediately. See Push Agents for deployment patterns.
wnp checks update <id>¶
Update a check's configuration.
wnp checks enable <id> / wnp checks disable <id>¶
Enable or disable a check without deleting it.
wnp checks delete <id>¶
Delete a check.
wnp checks results <id>¶
Show recent check results.
wnp checks transitions <id>¶
Show the state transition history for a check.
wnp checks alert <check-id>¶
Shortcut: create a notification policy (if none exists) and add a channel in one step.
wnp notify (alias: n)¶
wnp notify policy <check-id>¶
Show the notification policy for a check.
wnp notify set-policy <check-id>¶
Create or update a notification policy.
wnp notify set-policy <check-id> \
--cooldown 300 \
--recovery true \
--silence false \
--repeat 1800
| Flag | Default | Description |
|---|---|---|
--cooldown |
300 |
Seconds between alerts |
--recovery |
true |
Notify on recovery |
--silence |
false |
Silence all alerts |
--repeat |
0 |
Re-alert interval while down (0 = off) |
wnp notify add-channel <check-id>¶
Add a notification channel.
# Slack
wnp notify add-channel <check-id> --type slack --config url=https://hooks.slack.com/...
# Discord
wnp notify add-channel <check-id> --type discord --config url=https://discord.com/api/webhooks/...
# Webhook
wnp notify add-channel <check-id> --type webhook --config url=https://your-endpoint.example.com
# NATS
wnp notify add-channel <check-id> --type nats --config subject=alerts.my-service
# ntfy
wnp notify add-channel <check-id> --type ntfy --config url=https://ntfy.sh/my-alerts
wnp notify rm-channel <check-id> <channel-id>¶
Remove a notification channel.
wnp notify channels¶
List all notification channels across all checks.
wnp notify logs¶
Show recent notification delivery logs.
wnp relations (alias: rel)¶
wnp relations list¶
List all entity relations.
wnp relations add¶
Add a relation between two entities.
Types: depends_on, parent_of, calls, related_to.
wnp relations rm <id>¶
Remove a relation.
wnp team¶
wnp team list¶
List team members and pending invitations.
wnp team invite <email>¶
Invite a user.
Roles: admin, member.
wnp team remove <user-id>¶
Remove a team member.
wnp keys¶
wnp keys list¶
List all API keys.
wnp keys create <label>¶
Create a new API key. Copy the key immediately — it won't be shown again.
wnp keys delete <id>¶
Delete an API key.
wnp skills¶
MCP skill manifests power the MCP server.
wnp skills list¶
List registered skills.
wnp skills get <slug>¶
Show a skill and its tool definitions.
wnp skills enable <slug> / wnp skills disable <slug>¶
Toggle a skill on or off.
wnp skills delete <slug>¶
Delete a skill.