---
title: "byreal-cli by byreal-git · skilld"
canonical_url: "https://skilld.dev/gh/byreal-git/byreal-agent-skills"
meta:
  description: "Byreal DEX (Solana) all-in-one CLI: query pools/tokens/TVL, analyze pool APR & risk, open/close/claim CLMM positions, token swap, wallet & balance management.… From byreal-git/byreal-agent-skills."
  "og:description": "Byreal DEX (Solana) all-in-one CLI: query pools/tokens/TVL, analyze pool APR & risk, open/close/claim CLMM positions, token swap, wallet & balance management.… From byreal-git/byreal-agent-skills."
  "og:title": "byreal-cli by byreal-git"
  "twitter:description": "Byreal DEX (Solana) all-in-one CLI: query pools/tokens/TVL, analyze pool APR & risk, open/close/claim CLMM positions, token swap, wallet & balance management.… From byreal-git/byreal-agent-skills."
  "twitter:title": "byreal-cli by byreal-git"
---

`

[All skills](https://skilld.dev/skills)

[![byreal-git avatar](https://skilld.dev/_img/avatar?url=https%3A%2F%2Fgithub.com%2Fbyreal-git.png%3Fsize%3D96)](https://skilld.dev/gh/byreal-git)

# **/byreal-cli**

[@d8fcbc4](https://github.com/byreal-git/byreal-agent-skills/commit/d8fcbc4de4583d8dc40e2001d6089792f8648550 "Your agent reads SKILL.md at commit d8fcbc4")

by [byreal-git](https://skilld.dev/gh/byreal-git)· [byreal-git](https://skilld.dev/gh/byreal-git)/ [byreal-agent-skills](https://skilld.dev/gh/byreal-git/byreal-agent-skills)·44 stars

 6

Byreal DEX (Solana) all-in-one CLI: query pools/tokens/TVL, analyze pool APR & risk, open/close/claim CLMM positions, token swap, wallet & balance management. Use when user mentions Byreal, LP, liquidity, pools, DeFi positions, token swap, or Solana DEX operations.

- 1 file
- 2.5 KB
- Updated 6 months ago
- [GitHub](https://github.com/byreal-git/byreal-agent-skills/blob/d8fcbc4de4583d8dc40e2001d6089792f8648550/skills/byreal-cli/SKILL.md "View SKILL.md on GitHub")
- [1 warning](#third-party-checks "Third-party checks: 1 warning · 4 checks · Risk SAFE")

## SKILL.md

2.5 KB

**≈69** tokens always: the name and description. **≈499** when used: this file.

## Byreal LP Management

### Get Full Documentation

Always run these commands first to get complete, up-to-date documentation:

```
# Complete documentation (commands, parameters, workflows, constraints)
byreal-cli skill

# Structured capability discovery (all capabilities with params)
byreal-cli catalog list

# Detailed parameter info for a specific capability
byreal-cli catalog show <capability-id>
```

### Installation

```
# Check if already installed
which byreal-cli && byreal-cli --version

# Install
npm install -g @byreal-io/byreal-cli
```

### Check for Updates

```
byreal-cli update check
```

If an update is available:

```
byreal-cli update install
```

### Credentials & Permissions

- **Read-only commands** (pool, token, tvl, stats): No wallet required
- **Write commands** (swap, position open/close/claim): Require wallet setup via `byreal-cli wallet set` or `byreal-cli setup`
- Private keys are stored locally at `~/.config/byreal/keys/` with strict file permissions (mode 0600)
- The CLI never transmits private keys over the network — keys are only used locally for transaction signing
- AI agents should **never** ask users to paste private keys in chat; always direct them to run `byreal-cli setup` interactively

### Hard Constraints

1. **`-o json` only for parsing** — when showing results to the user, **omit it** and let the CLI's built-in tables/charts render directly. Never fetch JSON then re-draw charts yourself.
2. **Never truncate on-chain data** — always display the FULL string for: transaction signatures (txid), mint addresses, pool addresses, NFT addresses, wallet addresses. Never use `xxx...yyy` abbreviation.
3. **Never display private keys** - use keypair paths only
4. **Preview first** with `--dry-run`, then `--confirm`
5. **Large amounts (>$1000)** require explicit confirmation
6. **High slippage (>200 bps)** must warn user
7. **Check wallet before write ops** — run `wallet address` before any wallet-required command

Source: [SKILL.md on GitHub](https://github.com/byreal-git/byreal-agent-skills/blob/d8fcbc4de4583d8dc40e2001d6089792f8648550/skills/byreal-cli/SKILL.md)

## Third-party checks

<details>

<summary>1 warning5mo4 checks · Risk SAFE</summary>



- Gen Agent Trust Hub6mo

  The skill provides an interface for the Byreal CLI, a tool for managing Solana DEX operations and liquidity positions. It accesses local wallet configuration files for transaction signing and fetches its operational documentation dynamically from the CLI tool's output, which presents a surface for indirect prompt injection. It also includes instructions for installing and updating the vendor-provided CLI tool.
- Socket6mo

  No alerts
- Snyk6mo

  Risk: MEDIUM · 1 issue
- ZeroLeaks5mo

  Score: 93/100 · 2 sections analyzed

</details>

## Provenance

[Signed by skilld at d8fcbc4.](https://github.com/byreal-git/byreal-agent-skills/commit/d8fcbc4de4583d8dc40e2001d6089792f8648550 "d8fcbc4de4583d8dc40e2001d6089792f8648550") This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Steadyupdated 6 months ago

## Capability

<details>

<summary>Other metadata</summary>



<dl>

<dt>metadata</dt>
<dd>

```
{
  "openclaw": {
    "homepage": "https://github.com/byreal-git/byreal-agent-skills",
    "requires": {
      "bins": [
        "byreal-cli"
      ],
      "config": [
        "~/.config/byreal/keys/"
      ]
    },
    "install": [
      {
        "kind": "node",
        "package": "@byreal-io/byreal-cli",
        "global": true
      }
    ]
  }
}
```

</dd>

</dl></details>



## README badge

![README badge for byreal-git/byreal-agent-skills](https://skilld.dev/b/byreal-git/byreal-agent-skills?theme=light&label=0)

## Related skills

-
-
-
-
-
-