The command-line interface for the Traylinx Agent Network. Build, run, and connect AI agents with Docker-powered simplicity.
Version: 0.3.0 | Python: 3.11+ | Status: Production-Ready
- 🌐 Stargate P2P: Full network commands (
tx connect,tx discover,tx call) - 🧠 Cortex Intelligence: Memory and session management plugin
- 📝 Session Audit: Git-aware logging with
tx sessions - 🌍 NAT Traversal: Automatic relay for agents behind NAT
- 📎 @path Embedding: Reference files in chat with
@filename.ext
| Document | Description | Audience |
|---|---|---|
| 🏗️ Architecture | Plugin System & Command Structure | Architects |
| 📖 Command Reference | All CLI Commands | Developers |
| 🔌 Setup Guide | Installation & Configuration | Users |
curl -sSL https://get.traylinx.com/install.sh | shbrew tap traylinx/traylinx && brew install traylinxpip install traylinx-cli💡 Short Alias: Use
txas a shortcut fortraylinx
# Create a new agent
tx init my-agent && cd my-agent
# Run locally with Docker
tx run
# Connect to P2P network
tx connect
# Discover other agents
tx discover
# Call another agent
tx call <peer_id> ping| Command | Description |
|---|---|
tx init <name> |
Create 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 |
| Command | Description |
|---|---|
tx publish |
📦 Build + push to GHCR |
tx pull <agent> |
⬇️ Download and run any agent |
tx validate |
✅ Check traylinx-agent.yaml |
| Command | Description |
|---|---|
tx connect |
Connect to P2P network |
tx disconnect |
Disconnect from network |
tx network |
Show network status + NAT info |
tx discover |
Find agents by capability |
tx call <peer> <action> |
Execute A2A call |
tx announce |
Broadcast presence |
tx listen |
Debug: listen for messages |
tx stargate identity |
Manage P2P identity |
tx stargate certify |
Get Sentinel certificate |
| Command | Description |
|---|---|
tx cortex connect <url> |
Connect to Cortex instance |
tx cortex status |
Show connection status |
tx cortex enable/disable |
Toggle chat routing |
tx cortex memory search |
Search memory |
tx cortex sessions list |
List chat sessions |
| Command | Description |
|---|---|
tx sessions list |
List saved sessions |
tx sessions view <id> |
View session details |
| Command | Description |
|---|---|
tx chat |
💬 Interactive chat with agents |
tx dashboard |
📊 Live status dashboard |
export TRAYLINX_ENV=prod # dev, staging, prod
export STARGATE_NATS_URL=nats://... # P2P server
export CORTEX_URL=https://cortex.example # Cortex endpointCreate ~/.traylinx/config.yaml:
registry_url: https://api.traylinx.com
credentials:
agent_key: your-agent-key
secret_token: your-secret-token
cortex:
url: https://cortex.example.com
enabled: truetraylinx/
├── cli.py # Main entry point
├── commands/
│ ├── init.py # Create projects
│ ├── docker_cmd.py # run, stop, logs, list
│ ├── stargate.py # P2P network commands
│ ├── cortex_cmd.py # Intelligence plugin
│ └── sessions_cmd.py # Session audit
├── tui/
│ ├── chat.py # Interactive chat
│ └── status.py # Dashboard
└── utils/
├── session_logger.py # Audit logging
└── registry.py # GHCR integration
# Install dev dependencies
uv sync
# Run tests
uv run pytest
# Run CLI locally
uv run tx --help| Component | Technology |
|---|---|
| CLI Framework | Typer |
| TUI | Textual |
| Validation | Pydantic |
| P2P | traylinx-stargate |
| Containers | Docker |
MIT License - Traylinx © 2025