@termly-dev/cli-dev
Advanced tools
Access your AI coding assistants from any device. Works with Claude Code, Aider, GitHub Copilot, and any terminal-based AI tool.
macOS:
npm install -g @termly-dev/cli
Linux:
# Install build tools first (required for node-pty compilation)
# Amazon Linux / RHEL / CentOS / Fedora
sudo yum install gcc-c++ make python3 -y
# Ubuntu / Debian
sudo apt-get update && sudo apt-get install -y build-essential python3
# Then install CLI
npm install -g @termly-dev/cli
Windows:
npm install -g @termly-dev/cli
If installation fails, see Windows requirements below.
After installation, the termly command is available globally.
For beta testers and development:
npm install -g @termly-dev/cli-dev
This installs the termly-dev command which connects to the development environment.
Termly CLI requires build tools for compiling native dependencies (node-pty):
Build tools are required for installation:
Amazon Linux 2023 / RHEL / CentOS / Fedora:
sudo yum groupinstall "Development Tools" -y
# Or minimal:
sudo yum install gcc-c++ make python3 -y
Ubuntu / Debian:
sudo apt-get update
sudo apt-get install -y build-essential python3
Alpine Linux:
apk add --no-cache make gcc g++ python3
Windows x64 usually works out-of-the-box if you have Visual Studio installed. If not:
Required components:
Installation steps:
Option 1 - Visual Studio 2022 Community (Recommended):
npm install -g @termly-dev/cliOption 2 - Build Tools Only (Minimal):
npm install -g @termly-dev/cliIf you already have Visual Studio but installation fails:
Error: Spectre-mitigated libraries are required
Solution:
npm install -g @termly-dev/cliNote: Prebuilt binaries for node-pty may be available for Windows x64, in which case build tools aren't needed. The installer will try prebuilt first.
Works out-of-the-box. Xcode Command Line Tools usually installed automatically.
If needed:
xcode-select --install
ARM64 Linux (AWS Graviton, Raspberry Pi):
Windows ARM64:
Docker/Containers:
node:18 (Debian-based) already includes build-essentialTermly CLI supports three environments:
| Environment | Package | Command | Server URL | Use Case |
|---|---|---|---|---|
| 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.
cd /path/to/your/project
termly start
cd /path/to/your/project
termly-dev start
# Clone the repo
git clone https://github.com/termly-dev/termly-cli
cd termly-cli
npm install
# Run with local environment
TERMLY_ENV=local node bin/cli.js start
Run multiple sessions simultaneously:
# Terminal 1
cd ~/frontend
termly start
# Terminal 2 (new window)
cd ~/backend
termly start
Each session:
Manage sessions:
termly status # Show all sessions
termly stop abc-123 # Stop specific session
termly list # Quick list
Termly CLI supports 17 interactive terminal-based AI coding assistants:
And more... - Works with any terminal-based AI tool
All commands work the same way in both termly (production) and termly-dev (development).
termly setup
Interactive configuration setup (optional - sets default AI tool preference).
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 loggingExamples:
# Auto-detect and start
termly start
# Use Aider explicitly
termly start --ai aider
# Use Claude Code with custom directory
termly start /path/to/project --ai "claude code"
# Pass arguments to AI tool
termly start --ai aider --ai-args "--model gpt-4"
termly status [--all]
Show all active sessions with detailed information.
termly stop [session-id] [--all]
Stop one or all sessions.
termly list
Quick list of active sessions with encryption fingerprints for verification.
termly tools list # List available AI tools
termly tools detect # Detect installed tools
termly tools info <tool> # Show tool information
termly config # Show current configuration
termly config get <key> # Get config value
termly config set <key> <value> # Set config value
Examples:
termly config set defaultAI aider
termly config get defaultAI
Note: Server URL is determined by environment and cannot be changed via config.
termly cleanup
Remove stale sessions (processes that are no longer running).
Linux: "Error: not found: make" or "gyp ERR! build error"
Install build tools:
# Amazon Linux / RHEL / CentOS
sudo yum install gcc-c++ make python3 -y
# Ubuntu / Debian
sudo apt-get install build-essential python3 -y
Windows: "Spectre-mitigated libraries are required"
Install missing component:
See Windows requirements section for full Visual Studio setup.
Windows: "EPERM: operation not permitted" during cleanup
This is a warning, not an error. Installation likely succeeded. Verify:
termly --version
macOS: "gyp: No Xcode or CLT version detected"
Install Xcode Command Line Tools:
xcode-select --install
No AI tools detected?
termly tools list # Check what's installed
Install an AI tool:
pip install aider-chatgh extension install github/gh-copilotSession already running?
termly status # Find session ID
termly stop abc-123 # Stop it
Check your environment:
termly config # Shows current environment and server URL
Logs: ~/.termly/logs/cli.log
For issues: https://github.com/termly-dev/termly-cli/issues
# Install dependencies
npm install
# Run production mode
node bin/cli.js start
# Run development mode
node bin/cli-dev.js start
# Run local mode (custom server)
TERMLY_ENV=local node bin/cli.js start
# Debug mode
DEBUG=1 node bin/cli.js start --debug
npm publish
# Temporarily swap package files
cp package.dev.json package.json
npm publish
git checkout package.json
MIT
Made with ❤️ by the Termly Team
FAQs
Mirror your AI coding sessions to mobile - control Claude, Aider, Copilot, and 19+ tools from your phone (Development version)
The npm package @termly-dev/cli-dev receives a total of 4 weekly downloads. As such, @termly-dev/cli-dev popularity was classified as not popular.
We found that @termly-dev/cli-dev demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
The North Korean malware loader hides in a Packagist-listed package and its GitHub branch to fetch and execute remote code in a likely Contagious Interview-style lure.
Security News
The Rust project is moving toward formal rules on LLM use in contributions after months of internal debate over maintainer burden, code quality, and contributor experience.
Research
/Security News
A malicious NuGet package impersonating Sicoob exfiltrated client IDs, PFX passwords, and banking certificates through Sentry telemetry.