Developer Guide

How to use Argy as a developer: Argy Code, the LLM Gateway, and governed modules (golden paths).

Argy helps developers ship through standardized, governed building blocks (modules / golden paths) and governed AI access (LLM Gateway), without bypassing security, compliance, or platform standards.

Argy Code (Terminal)

Argy Code is an AI agent for developers, designed for both daily work and automation.

Execution modes

Interactive (TUI): human confirmations for day-to-day development.
Autonomous (argy run): non-interactive execution with deterministic exit codes (CI/CD, scripts, automation).

Install


# Homebrew
brew install demkada/tap/argy

# curl (Linux / macOS)
curl -fsSL https://github.com/demkada/argy-code/releases/latest/download/install.sh | sh

Authenticate

Argy supports Device Flow (RFC 8628) for agents and terminals and Personal Access Tokens (PAT).

argy auth login

PATs can be configured with durations (7 days to 1 year), with up to 25 active tokens per user, and can be revoked.

Core commands

argy models          # List available models
argy mcp list        # List MCP servers (tools)
argy agent list      # List available agents
argy run "prompt"    # Run autonomously (CI/CD-friendly)
argy session list    # Session history
argy stats           # Usage statistics
argy serve           # Local HTTP server for SDK access

LLM Gateway (OpenAI-compatible API)

The LLM Gateway is the unified entry point to LLM providers (OpenAI, Anthropic, Mistral, xAI, Google) with governance built in: quotas, security filters, and full auditing.

Endpoints

POST /v1/chat/completions
POST /v1/embeddings
POST /v1/agent/steps
GET /v1/models

Argy is multi-tenant. Requests carry tenant and organization context via headers:

x-tenant-id
x-org-id

Example: chat completion

# Pick a model ID from GET /v1/models
curl -X POST https://<your-llm-gateway>/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "x-tenant-id: <tenant-id>" \
  -H "x-org-id: <org-id>" \
  -d '{
    "model": "<model-id>",
    "messages": [
      { "role": "user", "content": "Summarize these run logs in 5 bullet points." }
    ]
  }'

Modules & Golden Paths (Self-service with guardrails)

Argy packages enterprise standards as versioned modules (golden paths): infrastructure provisioning, CI/CD steps, security checks, approval gates, and operational conventions. Developers consume them through the portal and Argy Code, while platform teams keep control through versioning and governance.