TLNT - Multi-Agent AI Collaboration Platform

TLNT is a powerful multi-agent AI collaboration platform that combines tmux orchestration with multi-LLM support for seamless human-AI collaboration.

🚀 Features

Multi-Agent Orchestration

• Tmux Integration: Each tmux pane represents a single AI agent
• Agent Coordination: Coordinated task execution across multiple agents
• Real-time Communication: Agent-to-agent messaging via HMS-NET
• Visual Theming: Custom themes for agent identification

Multi-LLM Support

• OpenAI Integration: GPT-4, GPT-3.5-turbo with native API support
• Anthropic Claude: Claude-3 family with streaming capabilities
• Google Gemini: Gemini Pro with advanced reasoning
• Unified Interface: Single API for all providers
• System Key Management: Native API key configuration

HMS System Integration

• HMS-NFO: Clojure-based ETL and data lake integration
• HMS-API: Laravel program management interface
• HMS-NET: Go-based agent communication system
• Cross-System Data Flow: Seamless integration across platforms

Professional CLI Experience

• React + Ink UI: Rich terminal user interface
• Commander.js: Robust command structure
• Agent Lifecycle: Discover, add, reload, and manage agents
• Status Monitoring: Real-time system and agent status

📦 Installation

npm install -g tlnt-cli

Or using yarn:

yarn global add tlnt-cli

🎯 Quick Start

1. Initialize a new session

tlnt new

2. Start with a specific provider

tlnt new --provider openai
tlnt new --provider anthropic
tlnt new --provider gemini

3. Use multi-agent theme

tlnt new --provider gemini --theme multi-agent

4. Check system status

tlnt status

🛠️ Configuration

API Keys

Set your API keys as environment variables:

export OPENAI_API_KEY="your-openai-key"
export ANTHROPIC_API_KEY="your-anthropic-key"
export GEMINI_API_KEY="your-gemini-key"

HMS System Integration

Configure HMS endpoints:

export HMS_NFO_URL="http://localhost:3000"    # Clojure ETL
export HMS_API_URL="http://localhost:8000"    # Laravel API
export HMS_NET_URL="http://localhost:9000"    # Go messaging

📚 Commands

Agent Management

tlnt agent add <name>           # Add new agent
tlnt agent list                 # List all agents
tlnt agent reload <name>        # Reload specific agent
tlnt agent remove <name>        # Remove agent

Session Management

tlnt new [options]              # Create new session
tlnt status                     # Show system status
tlnt themes                     # List available themes
tlnt providers                  # Show LLM providers

Development

tlnt dev                        # Start development mode
tlnt build                      # Build all packages
tlnt test                       # Run test suite

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│                    TLNT CLI Platform                        │
├─────────────────────────────────────────────────────────────┤
│  CLI Layer (React + Ink)                                   │
│  ├─ Agent Commands    ├─ Session Mgmt    ├─ Status Display │
├─────────────────────────────────────────────────────────────┤
│  Tmux Orchestration                                        │
│  ├─ Session Manager   ├─ Agent Registry  ├─ Theme Engine   │
├─────────────────────────────────────────────────────────────┤
│  Multi-LLM Abstraction                                     │
│  ├─ OpenAI Client     ├─ Anthropic Client ├─ Gemini Client │
├─────────────────────────────────────────────────────────────┤
│  HMS System Integration                                    │
│  ├─ HMS-NFO (Clojure) ├─ HMS-API (Laravel) ├─ HMS-NET (Go) │
├─────────────────────────────────────────────────────────────┤
│  Core Foundation                                           │
│  ├─ Config Management ├─ Tool Registry   ├─ Error Handling │
└─────────────────────────────────────────────────────────────┘

🧪 Development

Prerequisites

• Node.js >= 18.0.0
• npm >= 8.0.0
• tmux (for orchestration features)

Build from Source

git clone https://github.com/tlnt-cli/tlnt.git
cd tlnt
npm install
npm run build
npm test

Package Structure

packages/
├── core/     # LLM, HMS, Tmux orchestration
├── cli/      # Terminal UI and commands
└── sdk/      # External integration library

Scripts

npm run build        # Build all packages
npm run dev          # Development mode
npm run test         # Run tests
npm run lint         # Lint code
npm run format       # Format code
npm run typecheck    # Type checking
npm run clean        # Clean build artifacts

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Workflow

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes
4. Run tests: npm test
5. Commit changes: git commit -m 'Add amazing feature'
6. Push to branch: git push origin feature/amazing-feature
7. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙋 Support

• Documentation: GitHub Wiki
• Issues: GitHub Issues
• Discussions: GitHub Discussions

🏆 Acknowledgments

• Built with TypeScript for type safety
• UI powered by React and Ink
• CLI framework using Commander.js
• Testing with Vitest
• Integration with tmux for orchestration

TLNT - Empowering Multi-Agent AI Collaboration 🚀