by termly-dev
Mobile companion for Claude Code, Gemini CLI & OpenCode. Encrypted, remote
# Add to your Claude Code skills
git clone https://github.com/termly-dev/termly-cliLast scanned: 5/30/2026
{
"issues": [
{
"type": "npm-audit",
"message": "axios: Axios: Authentication Bypass via Prototype Pollution Gadget in `validateStatus` Merge Strategy",
"severity": "high"
},
{
"type": "npm-audit",
"message": "fast-uri: fast-uri vulnerable to path traversal via percent-encoded dot segments",
"severity": "high"
},
{
"type": "npm-audit",
"message": "uuid: uuid: Missing buffer bounds check in v3/v5/v6 when buf is provided",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "ws: ws: Uninitialized memory disclosure",
"severity": "medium"
}
],
"status": "WARNING",
"scannedAt": "2026-05-30T15:26:51.559Z",
"npmAuditRan": true,
"pipAuditRan": true
}termly-cli is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by termly-dev. Mobile companion for Claude Code, Gemini CLI & OpenCode. Encrypted, remote. It has 277 GitHub stars.
termly-cli returned warnings in SkillsLLM's automated security scan. It has no critical vulnerabilities, but review the flagged issues in the Security Report section before adding it to your workflow.
Clone the repository with "git clone https://github.com/termly-dev/termly-cli" and add it to your Claude Code skills directory (see the Installation section above).
termly-cli is primarily written in JavaScript. It is open-source under termly-dev on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh termly-cli against similar tools.
No comments yet. Be the first to share your thoughts!
Requires a passing catalog security scan. Resolve the flagged issues and resubmit to enable featuring.
Access your AI coding assistants from any device. Works with Claude Code, Aider, GitHub Copilot, and any terminal-based AI tool.
Previous versions:
pairing_expired error from server on reconnectTermly CLI includes prebuilt binaries for all platforms - no compilation required!
All Platforms:
npm install -g @termly-dev/cli
After installation, the termly command is available globally.
That's it! Works out-of-the-box on:
For beta testers and development:
npm install -g @termly-dev/cli-dev
This installs the termly-dev command which connects to the development environment.
Node.js 18+ - That's all you need!
Termly CLI uses @lydell/node-pty with prebuilt binaries for all platforms:
Installation typically completes in 10-30 seconds.
Termly 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 23+ interactive terminal-based AI coding assistants:
And more... - Works with any terminal-based AI tool that supports interactive TTY mode
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"
# Continue previous Claude Code session (restore context after restart)
termly start --ai claude-code --ai-args "--continue"
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).
Installation usually works flawlessly thanks to prebuilt binaries.
If you encounter issues:
"Cannot find module 'node-pty'"
Reinstall the package:
npm uninstall -g @termly-dev/cli
npm cache clean --force
npm install -g @termly-dev/cli
Permission errors on macOS/Linux
Use sudo or fix npm permissions:
# Option 1: Use sudo
sudo npm install -g @termly-dev/cli
# Option 2: Fix npm permissions (recommended)
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @termly-dev/cli
Windows: "EPERM: operation not permitted"
This is usually a warning, not a fatal error. Check if installation succeeded:
termly --version
If the command works, installation was successful.
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
Termly CLI uses a PTY (pseudo-terminal) to spawn AI tools locally and streams I/O through WebSocket with end-to-end encryption.
Mobile App <--[encrypted]--> WebSocket Server <--[encrypted]--> CLI <--[local]--> PTY <--> AI Tool
Key features:
For detailed architecture diagrams and data flow, see docs/ARCHITECTURE.md.
# Install dependencies
npm install
# Run production