Termly CLI
Access your AI coding assistants from any device. Works with Claude Code, Aider, GitHub Copilot, and any terminal-based AI tool.
Features
- 🚀 Universal AI Tool Support - Works with any terminal-based AI coding assistant
- 📱 Mobile Access - Control your AI tools from phone or tablet
- 🔒 End-to-End Encryption - AES-256-GCM + DH-2048 key exchange with fingerprint verification
- 🔄 Session Resume - Automatic reconnection with state synchronization
- 💻 Multiple Sessions - Run multiple AI tools simultaneously
- 🎯 Auto-Detection - Automatically finds installed AI tools
- ⚡ Zero-Knowledge Server - Server never sees your unencrypted data
- 🌍 Multiple Environments - Production, Development, and Local modes
- 🔄 Auto-Update Check - Ensures you're always running a supported version
Installation
Production (Stable)
npm install -g @termly-dev/cli
After installation, the termly command is available globally.
Development (Beta Testing)
For beta testers and development:
npm install -g @termly-dev/cli-dev
This installs the termly-dev command which connects to the development environment.
Environments
Termly CLI supports three environments:
| Production | @termly-dev/cli | termly | wss://api.termly.dev | End users |
| Development | @termly-dev/cli-dev | termly-dev | wss://dev-api.termly.dev | Beta testers |
| Local | Run from source | TERMLY_ENV=local termly | ws://localhost:3000 | Developers only |
Note: Server URLs are hardcoded per environment and cannot be changed by users.
Quick Start
Production
cd /path/to/your/project
termly start
Development
cd /path/to/your/project
termly-dev start
Local Development
git clone https://github.com/termly-dev/termly-cli
cd termly-cli
npm install
TERMLY_ENV=local node bin/cli.js start
Multiple Sessions
Run multiple sessions simultaneously:
cd ~/frontend
termly start
cd ~/backend
termly start
Each session:
- Independent AI tool instance
- Own WebSocket connection
- Can connect one mobile device
Manage sessions:
termly status
termly stop abc-123
termly list
Supported AI Tools
Termly CLI supports 17 interactive terminal-based AI coding assistants:
Official Tools from Major Companies
- Claude Code (Anthropic) - AI coding assistant
- OpenAI Codex CLI (OpenAI) - Official Codex CLI (April 2025)
- Google Gemini CLI (Google) - 1M token context
- GitHub Copilot CLI (Microsoft) - Command line AI
- Cody CLI (Sourcegraph) - AI assistant (Beta)
- Amazon Q Developer (AWS) - Free tier available
- Grok CLI (xAI/Elon Musk) - Grok AI assistant
Popular Open-Source Tools
- Aider - AI pair programming (35k+ stars)
- Continue CLI - Modular architecture
- OpenHands - Open-source Devin alternative
- OpenCode - Terminal-native (26k+ stars)
- Mentat - Git integration
- Cursor Agent - From Cursor ecosystem
Specialized Tools
- ChatGPT CLI - ChatGPT in terminal
- ShellGPT - Shell command assistant
- Ollama - Run LLMs locally (CodeLlama, etc)
- Blackbox AI - Debugging & file editing
And more... - Works with any terminal-based AI tool
Commands
All commands work the same way in both termly (production) and termly-dev (development).
Setup
termly setup
Interactive configuration setup (optional - sets default AI tool preference).
Start
termly start [directory] [options]
Start a new session with AI tool.
Options:
--ai <tool> - Specify AI tool to use
--ai-args <args> - Additional arguments for AI tool
--no-auto-detect - Disable auto-detection
--debug - Enable debug logging
Examples:
termly start
termly start --ai aider
termly start /path/to/project --ai "claude code"
termly start --ai aider --ai-args "--model gpt-4"
Status
termly status [--all]
Show all active sessions with detailed information.
Stop
termly stop [session-id] [--all]
Stop one or all sessions.
List
termly list
Quick list of active sessions with encryption fingerprints for verification.
Tools
termly tools list
termly tools detect
termly tools info <tool>
Config
termly config
termly config get <key>
termly config set <key> <value>
Examples:
termly config set defaultAI aider
termly config get defaultAI
Note: Server URL is determined by environment and cannot be changed via config.
Cleanup
termly cleanup
Remove stale sessions (processes that are no longer running).
Requirements
- Node.js 18+
- At least one AI coding assistant installed
- Mobile app (iOS/Android)
Troubleshooting
No AI tools detected?
termly tools list
Install an AI tool:
- Claude Code: https://docs.claude.com
- Aider:
pip install aider-chat
- GitHub Copilot:
gh extension install github/gh-copilot
Session already running?
termly status
termly stop abc-123
Check your environment:
termly config
Logs: ~/.termly/logs/cli.log
For issues: https://github.com/termly-dev/termly-cli/issues
Security
- End-to-end encryption (AES-256-GCM)
- Diffie-Hellman key exchange (2048-bit)
- Fingerprint verification - Compare encryption keys between CLI and mobile app
- Zero-knowledge server - Server cannot decrypt your data
- One mobile device per session
- Environment isolation - Production and development separated
- Version enforcement - Automatic check for minimum supported version
- Open source - Audit the code yourself
Development
npm install
node bin/cli.js start
node bin/cli-dev.js start
TERMLY_ENV=local node bin/cli.js start
DEBUG=1 node bin/cli.js start --debug
Publishing
Production Release
npm publish
Development Release
cp package.dev.json package.json
npm publish
git checkout package.json
License
MIT
Links
Made with ❤️ by the Termly Team