octopus, el CLI

octopus es la interfaz de línea de comandos del kernel: habla gRPC con Octopus y sigue la gramática recurso verbo. La referencia se genera desde el propio binario (Cobra), así que no puede desalinearse del código.

Cambio de nombre

Hasta el 2026-11-06 el comando se llamaba opus. Los scripts que lo invocan hay que actualizarlos. El archivo de configuración (~/.octopus/config.yaml) y las variables OCTOPUS_* no cambiaron: el código nunca leyó ~/.opus/ ni OPUS_*, así que no hay nada que migrar ni aviso de configuración vieja.

Gramática

Los recursos y sus verbos, en el orden del árbol de comandos:

Recurso	Verbos
account	get, list
apply	(sin verbo: apply -f <archivo>)
audit	check, reconcile, trace
balance	list, snapshots
config	get, init, list, set, profile {add,delete,list,show,use}
execution	get, list, wait
generate	accounts
holder	get, list
ledger	get, list
payment	order {cancel,capture,confirm,create,events,get,list}
profile	get, list
resource	diff, get, list, types
server	health, ping
tenant	create, get, list
transaction	execute, get, list

Alias: tx para transaction, pay para payment.

Instalación

Todavía no se publican binarios. Se compila desde octopus-cli, con octopus-grpc-sdk y octopus-protos como directorios hermanos (el go.mod los referencia con replace):

make -C octopus-cli build   # genera bin/octopus

El binario y el comando se llaman igual: octopus.

Primera sesión

Asume un kernel con la unidad USD y el perfil system.initial-funds ya aplicados (los ves con resource list y profile list). Los manifiestos de holder y cuenta son los AccountHolder y Account de apply.

octopus config init                                              # host, OpenID, perfil
octopus tenant create --name acme-bank --display-name "Acme Bank"
octopus config set default_tenant acme-bank                      # o --tenant en cada comando
octopus apply -f holder-y-cuenta.yaml                            # AccountHolder + Account
octopus account list                                             # copiá el ACCOUNT-ID
octopus transaction execute system.initial-funds \
  --input amount=500000 --input destination=<account-id> --detach -o json
octopus execution wait <execution-id>                            # espera el estado terminal
octopus balance list <account-id>

Comandos usados: config init, tenant create, config set, apply, account list, transaction execute, execution wait, balance list.

Siguiente: configuración, salida y scripting, operaciones diferidas.