Typed commands

What you can type on the input line. A line that’s one of these runs as your own request, and anything else goes to the agent, whole. ? with the input line empty shows the same list in the Candle Harness.

The examples use MOON for a token the Candle Harness has shown this session, and agent-a and agent-b for two agents.

Command	Example	What it does
buy 0.1 sol MOON	buy 0.5 usdc of MOON	Buys a token with an amount of SOL, USDC or CNDL. The token is its mint, or a name a pane or the agent has shown this session; a name nobody has shown is never guessed.
buy $25 MOON	buy $5 of MOON	Buys a dollar amount of a token, converted when the card is made into what it spends: SOL, unless config.toml’s trade.spendAsset says otherwise.
sell 50% MOON	sell 100% of MOON	Sells a percent of what the wallet holds of a token, from 1% to 100%, or an amount of it, such as sell 1000 MOON.
swap 0.1 SOL USDC	swap 25 USDC SOL	Swaps an amount between two base assets: SOL, USDC, CNDL, ETH or USDG. A token is bought or sold instead.
… as <agent>	buy $25 MOON as agent-b	Runs a trade or a candle command as another agent, with its key and limits, rather than the active agent’s.
… from <wallet>	buy $25 MOON from embedded	Pays from a wallet by its name or address, or embedded for the account’s embedded wallet. A wallet the agent can’t pay from is refused, saying why, before anything is sent.
paper · live	live	Switches between paper trades, which are recorded at the quoted price and never sent, and live trades, which move real funds. Switching to live asks first.
kill · resume	kill	The kill switch: buys pause, the agent stops, buy and swap cards are withdrawn, and each open sell gets a fresh card. resume turns buys back on.
resend · abandon	resend	For a trade Candle didn’t answer: resend sends it again under the same id where the tool has one, so it never runs twice (a post, a fee claim, a profile edit or an upload has none, and says so); abandon lets it go. Or click the trade in the agent pane.
agent <name>	agent agent-b	Makes another agent the active one: the agent your messages and typed lines go to.
pnl since 18:00	pnl since last session	Sets the window every P&L figure is measured over: pnl 24h, pnl since midnight, a time of day, or pnl since last session.
name <wallet> <name>	name Fk3eQ9mW2vT8rYp5LxN7cZ1bH4jS6dGuAa8KqRwEs2Vn main	Names a wallet, by its address or the name it has now. A TEE wallet’s name is Candle’s and a vault key’s is the vault’s, so those are renamed in the prompt pane; the Candle Harness’s own names change at once.
group <g> add <wallet>	group bots prefix bot-	Makes or changes a wallet group: add or remove wallets by name or address, prefix bot- to take every wallet whose name starts with it (prefix none drops it), or delete. A group organises wallets; it never pays.
forget vault	forget vault	Tells the Candle Harness the vault on this machine was removed on purpose, so owner steps run without the factor again. The Candle Harness checks there’s no vault first.
candle <command>	candle keys list	Runs any of Candle’s CLI commands under its rule: a read at once, the rest as a card or in the prompt pane.
… ; …	buy $1 of MOON; sell 100% of MOON	Up to 5 trades or candle commands, split by semicolons. Every part is checked before anything is sent, then each runs once the one before has ended; one that fails stops the rest.
<alias> …	b5 MOON	An alias from config.toml’s [aliases] stands for the start of a line: with b5 = "buy $5 of", b5 MOON buys $5 of MOON.
help · ?	help	Lists what you can type and every key. ? with the line empty opens it too.
anything else	what's moving on Solana right now?	Goes to the agent as a message. A line shaped like a trade that can’t run as typed says why instead, and sends nothing.