Connection Commands

The inconvo connection commands let you inspect, update, and resync your agent’s database connections.

connection get

Show metadata for a specific connection.

npx inconvo connection get --agent agt_123 --connection conn_456

If --connection is omitted, the CLI will prompt you to select from available connections.

Output

Connection details:

  My Database  conn_456
  status: ACTIVE
  owner: My Agent
  shared: no
  editable: yes

connection list

List all connections for an agent.

npx inconvo connection list --agent agt_123

connection list-shareable

List connections that can be shared with other agents.

npx inconvo connection list-shareable --agent agt_123

connection link

Link a shared connection to an agent.

npx inconvo connection link --agent agt_123 --connection conn_456

connection unlink

Unlink a shared connection from an agent.

npx inconvo connection unlink --agent agt_123 --connection conn_456

connection sync

Trigger a full database resync for a connection. This re-reads the schema from your database and updates the local .inconvo/ snapshot.

npx inconvo connection sync --agent agt_123 --connection conn_456

If --connection is omitted, the CLI will prompt you to select from available connections.

connection update

Update a connection’s description.

# Set a description
npx inconvo connection update --agent agt_123 --connection conn_456 \
  --description "Production analytics database"

# Clear the description
npx inconvo connection update --agent agt_123 --connection conn_456 \
  --clear-description

Common Options

All connection commands support these options:

Option	Description
--agent <agentId>	Target agent ID
--connection <connectionId>	Target connection ID
--json	Print JSON output
--api-key <apiKey>	API key override