Oximy CLI

Agent-facing CLI for governed tool execution through the Oximy trust layer.

Installation

cd apps/cli
pnpm install
pnpm build
npm link

For development:

pnpm dev -- <command>

Configuration

| Variable | Default | Description | |---|---|---| | OXIMY_API_URL | http://localhost:4000 | API base URL | | OXIMY_AGENT_ID | — | Agent ID (required for agent commands) |

export OXIMY_API_URL=http://localhost:4000
export OXIMY_AGENT_ID=agent_abc123

Agent Commands

These are top-level commands designed for AI agent invocation.

# Execute a tool call through Oximy's governance layer
oximy call gmail::send_email --to [email protected] --subject "Hello"

# Pre-check if a tool call would be ALLOW/HOLD/DENY (dry run)
oximy can gmail::send_email --to [email protected]

# Search the tool registry
oximy search "email"
oximy search "calendar" -n 5

# Show current trust score, level, confidence, volatility
oximy trust

# List available tools from connected integrations
oximy tools

# Quick status: trust score + pending approvals
oximy status

All agent commands support --json for structured JSON output.

Admin Commands

Nested under oximy admin for human operators.

# View policies for an agent
oximy admin policies <agentId>

# View approvals (all, pending, or resolved)
oximy admin approvals <agentId>
oximy admin approvals <agentId> --pending
oximy admin approvals <agentId> --resolved

# Approve or reject a held action
oximy admin approve <approvalId>
oximy admin reject <approvalId>

# View action log
oximy admin logs <agentId>
oximy admin logs <agentId> -n 50

# View agent details
oximy admin agent <agentId>

# Registry management
oximy admin registry list
oximy admin registry add --name "My Server" --description "Does things" \
  --capabilities "read,write" --categories "productivity" \
  --config-url https://example.com/mcp.json

All admin commands support --json for structured JSON output.