> For the complete documentation index, see [llms.txt](https://doc.lockerprotocol.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.lockerprotocol.com/hyper-agentic-trader/commands.md).

# Command reference

Every lpa command, its flags, an example, and what can go wrong.

`lpa --help` lists every command. A group word alone lists the commands of that group: `lpa perps`, `lpa pilot`, `lpa mandate`, and so on. `lpa help <command>` is the same as `lpa <command> --help`.

These pages are the command line's own words, for lpa 2.6.0. The application of Hyper Agentic Trader runs the same commands behind its screens and never names them; a page of this reference is the place to read what a screen did. The inventory of the commands is read from the program's source and kept as [commands.json](https://github.com/locker-protocol/doc/tree/main/agent/reference/commands.json), which a check compares with these pages: a command no page documents, or a page that cites a command the program no longer has, is refused.

## The groups

| Page                                                                                                               | Commands | What it covers                                                                                                                                            |
| ------------------------------------------------------------------------------------------------------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Setup and the guardian](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/setup-and-guardian.md)       | 12       | `setup`, `init`, how the account signs (`signer show`, `use vault`, `use browser`, `use mobile`, `forget`), `unlock`, `lock`, `status`, `doctor`, `panic` |
| [lpa perps](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/perps.md)                                 | 23       | markets, the assistant's reads, quotes, positions, the whole account, orders, the account's history, an order judged, and the movements of funds          |
| [lpa agent](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/agent.md)                                 | 4        | `show`, `renew`, `fee`, `revoke`                                                                                                                          |
| [lpa wallet](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/wallet.md)                               | 2        | `address`, `balances`                                                                                                                                     |
| [lpa paper](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/paper.md)                                 | 6        | the simulation account, the tape, the strategy replay                                                                                                     |
| [lpa policy](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/policy.md)                               | 2        | this computer's limits                                                                                                                                    |
| [lpa mandate](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/mandate.md)                             | 4        | the limits signed in your wallet                                                                                                                          |
| [lpa journal](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/journal.md)                             | 2        | what was done, the fees, and the export                                                                                                                   |
| [lpa store](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/store.md)                                 | 5        | the record, the tokens, pruning, export, backup                                                                                                           |
| [lpa copy](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/copy.md)                                   | 4        | copying a trader                                                                                                                                          |
| [lpa pilot](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/pilot.md)                                 | 30       | the pilot, the daily pilot, its strategies, its charter, the brain, calibration, the universe of markets, replay, memory, a model that does not answer    |
| [lpa live](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/live.md)                                   | 1        | the live page                                                                                                                                             |
| [lpa config](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/config.md)                               | 1        | the settings page, the included model first                                                                                                               |
| [lpa service and lpa console](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/service-and-console.md) | 9        | running round the clock, its console, and the chat of that console                                                                                        |
| [lpa hyperkeel](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/hyperkeel.md)                         | 15       | the connection and the plan, market data, leaderboards, followed traders, alerts, the switch of this computer, and the notices                            |
| [lpa mcp](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/mcp.md)                                     | 4        | the switch of the server for assistants                                                                                                                   |
| [lpa plugins](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/plugins.md)                             | 6        | someone else's commands                                                                                                                                   |
| [lpa profile](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/profile.md)                             | 5        | several accounts on one computer                                                                                                                          |
| [Housekeeping](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/housekeeping.md)                       | 2        | `reset`, `uninstall`                                                                                                                                      |

A hundred and thirty-six commands in all, and one more the help does not list, `lpa pilot rearm`, kept for the scripts of earlier versions. `lpa mcp` is the switch of the server for assistants on this computer; the server itself is its own program, `locker-mcp`, described in [MCP server and plugins](https://doc.lockerprotocol.com/hyper-agentic-trader/mcp-and-plugins.md).

Every command of every page:

| Group       | Commands                                                                                                                                                                                                                                                                                                                                                               |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| alone       | `setup`, `init`, `journal`, `unlock`, `lock`, `status`, `panic`, `doctor`, `config`, `live`, `console`, `notices`, `uninstall`, `reset`                                                                                                                                                                                                                                |
| `perps`     | `venues`, `markets`, `quote`, `regime`, `ranges`, `analyze`, `scan`, `positions`, `balance`, `portfolio`, `orders`, `fills`, `funding`, `fees`, `ledger`, `open`, `check`, `close`, `cancel`, `modify`, `deposit`, `withdraw`, `transfer`                                                                                                                              |
| `signer`    | `show`, `use vault`, `use browser`, `use mobile`, `forget`                                                                                                                                                                                                                                                                                                             |
| `agent`     | `show`, `renew`, `fee`, `revoke`                                                                                                                                                                                                                                                                                                                                       |
| `wallet`    | `address`, `balances`                                                                                                                                                                                                                                                                                                                                                  |
| `paper`     | `init`, `status`, `on`, `off`, `record`, `replay`                                                                                                                                                                                                                                                                                                                      |
| `policy`    | `show`, `set`                                                                                                                                                                                                                                                                                                                                                          |
| `mandate`   | `sign`, `show`, `revoke`, `release`                                                                                                                                                                                                                                                                                                                                    |
| `journal`   | `export`                                                                                                                                                                                                                                                                                                                                                               |
| `store`     | `status`, `tokens`, `prune`, `export`, `backup`                                                                                                                                                                                                                                                                                                                        |
| `copy`      | `start`, `stop`, `status`, `resume`                                                                                                                                                                                                                                                                                                                                    |
| `pilot`     | `start`, `stop`, `pause`, `resume`, `status`, `ask`, `run-now`, `follow`, `day`, `deliberate`, `model-down`, `end-grid`, `end-range`, `schedule`, `charter`, `strategy list`, `strategy show`, `strategy use`, `strategy save`, `strategy remove`, `strategy choice`, `strategy draft`, `plans`, `replay`, `brain`, `calibrate`, `universe`, `notes`, `rules`, `rearm` |
| `console`   | `password`                                                                                                                                                                                                                                                                                                                                                             |
| `service`   | `install`, `status`, `logs`, `start`, `stop`, `restart`, `uninstall`                                                                                                                                                                                                                                                                                                   |
| `hyperkeel` | `login`, `status`, `logout`, `off`, `on`, `brief`, `leaders`, `follows`, `follow`, `unfollow`, `alerts`                                                                                                                                                                                                                                                                |
| `notices`   | `on`, `off`, `test`                                                                                                                                                                                                                                                                                                                                                    |
| `mcp`       | `on`, `off`, `status`, `forget`                                                                                                                                                                                                                                                                                                                                        |
| `plugins`   | `install`, `list`, `inspect`, `remove`, `disable`, `enable`                                                                                                                                                                                                                                                                                                            |
| `profile`   | `list`, `add`, `use`, `rename`, `remove`                                                                                                                                                                                                                                                                                                                               |

## How to write a command

`lpa <group> <command> --flag value`. `--flag=value` works too. A flag the command does not know, or a word that is not a flag, is refused with `BAD_ARGUMENTS`.

| Kind of value | How to write it                                                    | Example                                      |
| ------------- | ------------------------------------------------------------------ | -------------------------------------------- |
| Market        | the name Hyperliquid uses; a market of a HIP-3 dex is `dex:TICKER` | `BTC`, `ETH`, `xyz:GOLD`                     |
| Size          | in the base asset, not in dollars                                  | `--size 0.03` is 0.03 ETH                    |
| Leverage      | a whole number                                                     | `--leverage 3`                               |
| Price         | a plain decimal                                                    | `--tp 2750`                                  |
| Amount        | USDC, a plain decimal                                              | `--amount 25`                                |
| Dex           | its name, `main` for the main one                                  | `--dex xyz`, `--to-dex main`                 |
| Address       | `0x` and 40 hex characters                                         | `--address 0x5b5d...c060`                    |
| Moment        | a duration back from now, a day, a date, or a timestamp in ms      | `24h`, `7d`, `30m`, `20260929`, `2026-09-29` |

## Global flags

| Flag                      | Effect                                                                                                                                                                                |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--json`, `--format json` | the result as JSON, the same shape the MCP server returns                                                                                                                             |
| `--format human`          | the default                                                                                                                                                                           |
| `--profile <name>`        | the account the line runs for, when this computer holds several ([lpa profile](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/profile.md)); `LPA_PROFILE` says the same |
| `--help`, `-h`            | the command's usage. `lpa --help` lists every command                                                                                                                                 |
| `--version`, `-v`         | the version                                                                                                                                                                           |

They go anywhere on the line. `--` ends the reading of them: what follows is taken as written. Written where an option waits for a value, `-h` or `-v` **is** that value, and the option refuses it rather than printing the help.

Text for a person goes to the standard output, progress lines to the standard error. The interactive session takes neither `--json` nor `--format`: every answer there is a block for a person.

## Confirmation

Every command that signs, fills or removes something asks the person at the terminal (`[y/N]`). The exception is the pilot: once you armed it, or ran `lpa pilot run-now --live`, its own orders are signed under the mandate without a question for each one.

Where there is no terminal, it refuses with `CONFIRMATION_REQUIRED` unless the line carries `--yes`, which says the user already agreed. `--dry-run`, on `perps open` and `perps close`, runs the quote and the policy and stops before any signature; on `perps cancel --all` it lists what would be cancelled. `lpa perps check` goes further: it quotes an order, says whether the limits let it through, and acts on nothing, so it takes neither `--yes` nor `--dry-run`.

The interactive session never takes `--yes`: the menu is what confirms there. `lpa pilot start` never takes it at all.

## Commands only a person can run

These refuse to run in an agent's shell, whatever the flags, because they ask for a password or are the person's own settings. The ones that ask for a password refuse with `LOCKED`, the others with `CONFIRMATION_REQUIRED`, and each hint says what to ask the user:

| Command                  | Code                    | Why                                                                      |
| ------------------------ | ----------------------- | ------------------------------------------------------------------------ |
| `lpa init`               | `LOCKED`                | a password, and your wallet on a local page (with the Vault, the webcam) |
| `lpa unlock`             | `LOCKED`                | the password of the sealed key                                           |
| `lpa console password`   | `LOCKED`                | a password, typed twice                                                  |
| `lpa mandate release`    | `LOCKED`                | the password                                                             |
| `lpa setup`              | `CONFIRMATION_REQUIRED` | it asks, it waits on your wallet, it takes passwords                     |
| `lpa signer use`         | `CONFIRMATION_REQUIRED` | your wallet proves it signs for the account, on a local page             |
| `lpa config`             | `CONFIRMATION_REQUIRED` | the person's own settings                                                |
| `lpa live`               | `CONFIRMATION_REQUIRED` | the page is the person's, on this computer                               |
| `lpa hyperkeel login`    | `CONFIRMATION_REQUIRED` | the sign-in happens in the browser                                       |
| `lpa uninstall`          | `CONFIRMATION_REQUIRED` | it removes the program                                                   |
| `lpa doctor --fix-modes` | `CONFIRMATION_REQUIRED` | it changes the modes of your files                                       |

`lpa agent renew` and `lpa agent fee` are the person's too: your wallet signs them. So are `lpa pilot start`, `stop`, `pause`, `resume` and `ask`, `lpa pilot schedule --on`, every change to the pilot's notes, rules and brain, and the switches of this computer (`lpa mcp off`, `lpa hyperkeel off`, `lpa notices on`).

## Simulation or real

* `--paper` sends one command to the simulation account.
* `lpa paper on` sends every `perps` command there until `lpa paper off`.
* `--address` always reads that account on Hyperliquid, never the simulation one.

While simulation mode is on, `cancel` and `modify` act on the simulation account's triggers and on the stops and targets of its positions; a leverage change, `deposit`, `withdraw` and `transfer` are refused, so nothing reaches the real account by mistake.

## `--venue`

The `perps` commands accept `--venue hyperliquid`, so recipes written for other agent wallets carry over. Hyperliquid is the only venue, and any other value is refused by name. `lpa perps venues`, which lists the venues, is the one that does not take it.

## Error codes

A code is never renamed. A new situation gets a new code.

| Code                      | Meaning                                                                                                                                                                               | What to do                                                                                                                                     |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `BAD_ARGUMENTS`           | a flag missing, malformed, or two flags that exclude each other                                                                                                                       | read the hint; `lpa <command> --help`                                                                                                          |
| `UNKNOWN_COMMAND`         | no such command                                                                                                                                                                       | `lpa --help`                                                                                                                                   |
| `NOT_INITIALIZED`         | no account yet                                                                                                                                                                        | `lpa setup` (it asks how the account signs, Locker Vault first), or `--paper`                                                                  |
| `PAPER_NOT_INITIALIZED`   | no simulation account yet                                                                                                                                                             | `lpa paper init`                                                                                                                               |
| `LOCKED`                  | the guardian holds no key, or the command needs a person at a terminal                                                                                                                | `lpa unlock`, or run the command yourself                                                                                                      |
| `AGENT_EXPIRED`           | the agent's time is over                                                                                                                                                              | `lpa agent renew`                                                                                                                              |
| `AGENT_NOT_APPROVED`      | no agent, or Hyperliquid does not list it yet                                                                                                                                         | `lpa init`; after an interrupted one, wait a minute                                                                                            |
| `NEEDS_DEPOSIT`           | not enough USDC or gas on Arbitrum                                                                                                                                                    | send USDC, or a little ETH, to the account                                                                                                     |
| `INSUFFICIENT_MARGIN`     | the dex, or the simulation account, has less available than the order needs                                                                                                           | a smaller amount, or `lpa perps balance --all-dexes`                                                                                           |
| `POLICY_REJECTED`         | an order outside the policy                                                                                                                                                           | a smaller order, or `lpa policy set`, by the person                                                                                            |
| `BELOW_MIN_ORDER`         | under Hyperliquid's $10 minimum                                                                                                                                                       | a larger `--size`; the hint gives it                                                                                                           |
| `MARKET_HALTED`           | the market does not trade now                                                                                                                                                         | another market, or later                                                                                                                       |
| `CONFIRMATION_REQUIRED`   | the user's go is missing                                                                                                                                                              | show the quote; once they agree, `--yes`                                                                                                       |
| `ORDER_REJECTED`          | Hyperliquid refused the order                                                                                                                                                         | read its reason, quoted word for word                                                                                                          |
| `HYPERLIQUID_ERROR`       | anything else Hyperliquid said                                                                                                                                                        | read it; `lpa doctor`                                                                                                                          |
| `NETWORK_ERROR`           | a network call failed                                                                                                                                                                 | check the connection; `lpa doctor`                                                                                                             |
| `CANCELLED`               | cancelled before anything was signed                                                                                                                                                  | nothing happened                                                                                                                               |
| `HYPERKEEL_NOT_CONNECTED` | a hyperkeel command without the connection                                                                                                                                            | `lpa hyperkeel login`                                                                                                                          |
| `HYPERKEEL_ERROR`         | hyperkeel refused or failed                                                                                                                                                           | read it; try again later                                                                                                                       |
| `SERVICE_ERROR`           | the system's service manager refused                                                                                                                                                  | `lpa service logs`                                                                                                                             |
| `LOCAL_STATE`             | a file of `~/.lpa` cannot be read or written, a `policy.json` that does not read among them; or signing with a mobile wallet asked of a program that does not offer it                | `lpa doctor`; for the mobile wallet, Locker Vault or your browser extension                                                                    |
| `MANDATE_INVALID`         | the mandate is not one this account signed for this agent, or a live pilot has no mandate allowing `pilot`                                                                            | `lpa mandate sign` again, in your wallet                                                                                                       |
| `MANDATE_OUTDATED`        | the mandate was signed before lpa 2.4.0, in the form that carried a daily loss limit, which no longer exists: nothing opens under it, closing stays allowed                           | `lpa mandate sign` again, in your wallet                                                                                                       |
| `NO_MODEL`                | the pilot needs a model and reaches none                                                                                                                                              | `lpa config`, or `--model`. A key typed in one shell is not seen by a guardian started elsewhere                                               |
| `NO_CREDITS`              | the model included with the Hyper Agentic Trader plan refused the call: no credits left this month, the account suspended, or the free budget of the day used; nothing is tried again | a bigger plan or a top-up on hyperagentictrader.com, or a personal key or a local model in `lpa config`; the pilot tries again after 00:00 UTC |
| `SPEND_CEILING`           | the day's spend on the model has reached the ceiling set for the assistant in `lpa config`; nothing was asked of the model                                                            | wait for 00:00 UTC, or raise or clear the ceiling in `lpa config`                                                                              |
| `PLUGIN_REFUSED`          | a plugin was stopped, or is turned off                                                                                                                                                | read the reason; `lpa plugins inspect --name <plugin>`, `lpa plugins enable --name <plugin>`                                                   |
| `QUOTE_STALE`             | a quote confirmed too late, already used, or whose order changed since                                                                                                                | look at the new quote, then confirm it                                                                                                         |
| `VERSION_MISMATCH`        | the guardian runs another version than the program asking it                                                                                                                          | bring `lpa` to the latest release (run the installer again), then `lpa lock` and `lpa unlock`; for a service, `lpa service restart`            |
| `VAULT_ANSWER_MISMATCH`   | the answer is signed by another account than the one asked (another account chosen in your wallet, or a Vault of another version). Nothing was sent                                   | check the account your wallet shows, update both sides, run it again                                                                           |

A refusal exits with code 1 and carries its code, a sentence and, most of the time, what to do next:

```
$ lpa perps open --symbol ETH --side long --size 0.05 --leverage 3 --paper
Error [POLICY_REJECTED]: The policy refuses this order: $133.47 is above the $100 per order.
Hint: See `lpa policy show`. Closing and cancelling are always allowed.
```

With `--json`, the same thing as data:

```json
{
  "error": {
    "code": "CONFIRMATION_REQUIRED",
    "message": "Simulated long 0.03 ETH at 3x needs the user's go.",
    "hint": "Show the quote to the user; once they agree, run the same command with --yes."
  }
}
```

## The interactive session

`lpa` alone opens a session: a banner, a prompt, each answer as a block, and a status line after every exchange. Three ways to act there:

* a `/` command, the short form of a command: `/quote ETH long 0.03 3x tp 2750 sl 2600`,
* any command by its whole path, `/perps transfer --amount 5 --to-dex xyz`, or pasted as a shell line,
* plain words, which go to the assistant once a model is set up.

Live views answer keys: `/markets`, `/chart BTC`, `/leaders week`, `/trader 0x...`, `/radar`. In the lists, `c` prepares a copy in simulation and `f` follows a trader. At the prompt, Tab completes names, markets, sizes, leverage and prices; Ctrl-C clears the line and twice in a row leaves. In a menu, Esc picks the last option, which is always the one that does nothing.
