Ask ERPC AI in your terminal and let it act with your approval
erpc ai opens a conversation with ERPC AI in your terminal. It answers from ERPC's documentation and your account, and with your approval it can act for you.This page describes ERPC CLI
v0.1.0-rc.4, a pre-release. ERPC AI needs an ERPC account; plans and token packs are on ERPC AI.Start a conversation
Sign this machine in with
erpc login (Sign in and keys), then open a conversation:bash
erpc with no command opens the same console. erpc ai -m asks one question and prints the answer. erpc ai -c continues the last conversation, also with -m or a question piped in. erpc resume picks any saved conversation from a list, and erpc resume <id> continues the one with that id.Conversations are saved under
~/.erpc/conversations/, readable by you alone.What ERPC AI can do with your approval
- Start and end hourly products.
- Buy ERPC Credit with EURC from your wallet.
- Wait for a new VPS to come up, log in to it once with the password ERPC set, put your key in place and turn password logins off for good.
- Allow SSH only from your address.
ERPC AI drives the same erpc commands you would type, and prefers them to improvised scripts. You can also build and deploy an app by talking to it: see erpc worker quickstart.
What ERPC AI asks before it acts
When ERPC AI needs a decision, it offers choices to pick with the arrow keys and Enter.
Its own actions in the list above ask you first, every time, with the cursor on Stop. Allowing every command does not change that.
It can also run commands on your own computer. Commands that only look run at once. Any other command is shown word for word and asks each time: you may allow that exact command, or every command, scripts included, behind a second question.
Once every command is allowed, nothing is asked before a command runs until
erpc ai ends or /new (or /clear) starts a new conversation. A command given --yes that spends money or changes a server runs too, and a command that prints a key file or a password hands it to ERPC AI.What ERPC AI sees
Everything a tool returns is sent to the model through the ERPC AI gateway, as part of the conversation.
- Commands on your computer: what any command prints goes to ERPC AI, logs included. Only the values of
api-key=,api_key=,apikey=andtoken=parameters are hidden. - Your account: the tools that read your account never pass on server passwords, IP whitelists, endpoints that carry a key, payment details, API keys or the session. For each of the account's VPSs, its IP and login user do reach the model, so you can ask where it is.
- A new VPS: while ERPC AI sets one up, its IP and login user (never its password), its host key fingerprint, your own public address and the addresses SSH is allowed from reach the model too.
What the assistant reads in SECURITY.md lists what each tool passes on.
Choose the model size
By default, each turn's words decide the model size: small for a greeting and large for the rest. To put every turn on one size, start with
--model (also with -m or -c), or type /model in the console:bash
The sizes are
small, medium, large and xlarge, the most capable, which uses your tokens at 2x. /model auto goes back to letting each turn's words decide, and /model alone says which size is in use.- Changing the size in a conversation reads the whole conversation again at the new size, once.
- The choice lasts until
erpc aiends,/newincluded, and the console names the size under each answer. - A size the service does not offer is answered at its default size, and the console says so.
- The suggested next message and the summary of a long conversation stay on the small size.
Commands inside a conversation
After each answer, the box shows a dimmed suggestion for your next message. Tab puts it in the box for you to edit or send, and nothing is sent until you press Enter. Each suggestion is one extra small request, sent the words of the last two turns only, never tool results.
Long conversations are summarised automatically to keep them affordable, and the summarised turns stay on disk.
Memory
ERPC AI can remember short facts about you, such as your hosts, chains and preferences, from one conversation to the next. They are kept in
~/.erpc/memory.json, and nothing that looks like a secret is saved. erpc memory list, forget <n> and clear show and delete them.Give the skills to another AI agent
Skills are what ERPC AI knows about each chain and service.
erpc skills install (or erpc skills sync) writes them out for another AI agent to use. The skills ship inside erpc, checked against its commands, so they always match the version you run. After an upgrade, erpc doctor warns while the copies on disk are older.Pay from a wallet
erpc wallet create sets up your one Base wallet. It uses the ERPC wallet already in 1Password if there is one, and makes a new one only when there is none. A new wallet's private key goes straight to 1Password and is never written to disk or shown.Fund the wallet with EURC, and ERPC AI can buy ERPC Credit from it after you approve each purchase.
erpc wallet create --no-ai keeps ERPC AI from asking, and --vault takes the 1Password vault's id or name. erpc wallet show shows the wallet's address.