Model Commands

The inconvo model commands let you manage your agent’s semantic model — the configuration that tells Inconvo how to interpret your data.

model pull

Pull semantic model files from Inconvo into a local .inconvo/ directory.

npx inconvo model pull

Options

Option	Description
--agent <agentId>	Target agent ID (repeatable for multiple agents)
--all-agents	Pull all agents in the organisation
--connection <connectionId>	Restrict pull to one connection (requires exactly one --agent)
--json	Print JSON output
--api-key <apiKey>	API key override

Examples

# Interactive mode — prompts you to select agents
npx inconvo model pull

# Pull a specific agent
npx inconvo model pull --agent agt_123

# Pull all agents
npx inconvo model pull --all-agents

# Pull a specific connection for an agent
npx inconvo model pull --agent agt_123 --connection conn_456

model agent list

List all agents available in your organisation.

npx inconvo model agent list

# JSON output
npx inconvo model agent list --json

model action

Run generic model actions or inspect the action schema.

action run

Execute a model action from a raw JSON payload.

npx inconvo model action run \
  --agent agt_123 \
  --action <action_type> \
  --payload '{"key": "value"}'

Option	Description
--agent <agentId>	Target agent ID (required)
--action <action>	Action type (required)
--payload <json>	Action payload as JSON (required)
--connection <connectionId>	Connection ID (required for some actions)
--dry-run	Print resolved payload without applying
--no-sync	Skip post-mutation sync

action schema

List all supported model actions and their metadata.

npx inconvo model action schema --json

Mutation Commands

The following commands modify specific parts of the semantic model. They all support --agent, --connection, --dry-run, --no-sync, and --json options.

Command	Description
inconvo model table	Set table access mode (queryable, joinable, off) and table prompts
inconvo model column	Toggle columns on/off
inconvo model computed	Create, update, or delete computed columns
inconvo model relation	Toggle relations on/off
inconvo model condition	Manage conditions on tables
inconvo model policy	Manage access policies
inconvo model virtual	Manage virtual tables
inconvo model user-context	Configure user context fields and context filters

Tip

Use --dry-run on any mutation command to preview changes before applying them.