Yertle CLI

A command-line client for the Yertle API.

The Yertle CLI is an open-source Go command-line client for exploring and scripting Yertle workspaces. It’s the easiest way to authenticate and the fastest way to inspect your data from the terminal.

Repo: model-context/yertle-cli

Installation

brew tap model-context/yertle
brew install yertle

Common commands

# Authenticate
yertle auth login

# Show current config and authentication state
yertle config
yertle auth status

# List organizations
yertle orgs

# List nodes in the active org
yertle nodes

# Inspect one node
yertle nodes <node-id>

# Render the containment hierarchy
yertle tree

# Render an ASCII canvas of a node and its children
yertle canvas <node-id>

# Natural-language search: rank nodes most likely to match a query
yertle rag "api gateway in the webapp"

# Same search, plus parents/children/connections of the matches
yertle rag "checkout payment" --expand standard

Output formats

Most commands support --format table, --format json, or --format csv:

yertle orgs --format json
yertle nodes --format csv

Configuration

The CLI stores config at ~/.yertle/config.json. You can override the API URL or org scope with environment variables or flags:

export YERTLE_API_URL=https://api.yertle.com
export YERTLE_ORG=<org-id>

Contributing

The CLI is open source and welcomes contributions. The API reference on this docs site is the source of truth for endpoint signatures and request/response shapes — use it when adding new commands.

See contributing.md in the CLI repo for details.