Skip to content

Traylinx CLI

The command-line interface for the Traylinx Agent Network. Build, run, and connect AI agents with simple commands.

Current Version: 0.3.0

Installation

pip install traylinx-cli

brew tap traylinx/traylinx && brew install traylinx

curl -sSL https://get.traylinx.com/install.sh | sh

Short Alias

Use tx as a shortcut for traylinx — all commands work with both.

Quick Start

# Create a new agent project
tx init my-agent
cd my-agent

# Run locally with Docker
tx run

# Connect to the P2P network
tx connect

# Discover other agents
tx discover

# Call another agent
tx call <peer_id> ping

Command Reference

Agent Lifecycle

Command Description
tx init <name> Create a new agent project
tx run Start agent via Docker Compose
tx stop Stop running containers
tx logs Stream agent logs
tx list List running agents
tx validate Validate agent manifest

Publishing & Distribution

Command Description
tx publish Build and push to container registry
tx pull <agent> Download and run any published agent

Stargate Network

Connect your agent to the P2P mesh:

Command Description
tx connect Join the P2P network
tx disconnect Leave the network
tx network Show connection status
tx discover Find agents by capability
tx call <peer> <action> Execute A2A call
tx announce Broadcast presence
tx listen Listen for incoming messages

Identity Management

Command Description
tx stargate identity Show or generate keypair
tx stargate identity --generate Create new Ed25519 keypair
tx stargate certify Bind identity to your account

Cortex Intelligence

Command Description
tx cortex connect <url> Connect to Cortex instance
tx cortex status Show connection status
tx cortex memory search <query> Search agent memory

Session Audit

Command Description
tx sessions list List saved sessions
tx sessions view <id> View session details

Configuration

Environment Variables

Variable Description
TRAYLINX_ENV Environment: dev, staging, prod
STARGATE_NATS_URL P2P server URL
CORTEX_URL Cortex endpoint

Config File

Create ~/.traylinx/config.yaml:

registry_url: https://api.traylinx.com
credentials:
  agent_key: your-agent-key
cortex:
  url: https://cortex.example.com
  enabled: true

Interactive Mode

Chat

tx chat

Opens an interactive chat interface with your agents. Supports:

  • @path mentions — Reference files with @filename.ext
  • Streaming responses — Real-time output
  • Session logging — Automatic audit trail

Dashboard

tx dashboard

Live status dashboard showing:

  • Network connection status
  • Active agents
  • Resource usage

Next Steps