https://github.com/softwarity/aipilot-cli
https://github.com/softwarity/aipilot-cli
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/softwarity/aipilot-cli
- Owner: softwarity
- Created: 2026-01-12T10:56:54.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-03-29T07:39:47.000Z (3 months ago)
- Last Synced: 2026-04-02T08:36:16.328Z (3 months ago)
- Language: Go
- Homepage: http://aipilot.softwarity.io/
- Size: 12 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AIPilot CLI
[](https://github.com/softwarity/aipilot-cli/releases/latest)
[](https://github.com/softwarity/aipilot-cli/actions/workflows/ci.yml)
Bridge your terminal to the **AIPilot mobile app** via WebSocket relay. Control your AI coding agents (Claude Code, etc.) from your phone using voice input. No SSH required, no ports to open.
## Open Source & Privacy
**This CLI is fully open source.** You can inspect, audit, and build it yourself.
- **Source code**: Available right here on GitHub
- **No telemetry**: We don't collect any usage data or analytics
- **No tracking**: No user behavior tracking whatsoever
- **No accounts**: No registration or sign-up required
- **Encrypted**: All communications use TLS/WSS encryption
- **Ephemeral relay**: The relay server only forwards encrypted messages in real-time, no data is stored
The relay simply acts as a bridge between your PC and phone. Your terminal data passes through encrypted and is never logged or stored.
## What is AIPilot?
AIPilot transforms your smartphone into a **voice remote control** for AI coding agents (Claude Code, Gemini CLI, Codex).
- **Voice Input**: Talk to your AI agent instead of typing
- **Hands-free Coding**: Keep coding from your couch, standing desk, or anywhere in the room
- **Real-time Output**: See AI responses on your phone as they stream
## How it works
```
┌─────────────────┐ WebSocket ┌─────────────────┐
│ │ via Relay │ │
│ AIPilot CLI │◄──────────────────────►│ AIPilot App │
│ (Your PC) │ │ (Your Phone) │
│ │ │ │
└────────┬────────┘ └─────────────────┘
│ 📱 Voice Input
│ Spawns 📱 Commands
▼ 📱 File Sharing
┌─────────────────┐
│ AI Agent │
│ (Claude Code) │
└─────────────────┘
```
1. **Run the CLI** on your PC - it displays a QR code
2. **Scan the QR code** with the AIPilot mobile app
3. **Talk to your AI agent** using voice input
4. **See responses** streaming in real-time on your phone
All communication goes through a secure relay - no need to open ports or configure your firewall.
## Installation
### Quick install (recommended)
The installer downloads the latest release and installs it to your user directory. **No sudo or admin rights required.**
**Linux / macOS:**
```bash
curl -fsSL https://raw.githubusercontent.com/softwarity/aipilot-cli/main/install.sh | bash
```
**Windows (PowerShell):**
```powershell
irm https://raw.githubusercontent.com/softwarity/aipilot-cli/main/install.ps1 | iex
```
The installer:
- Detects your OS and architecture automatically
- Downloads the latest release from GitHub
- Installs to `~/.local/bin` (Linux/macOS) or `%LOCALAPPDATA%\Programs\aipilot` (Windows)
- Adds to PATH if needed
### Manual download
| Platform | Architecture | Download |
|----------|--------------|----------|
| Linux | amd64 | [aipilot-cli-linux-amd64](https://github.com/softwarity/aipilot-cli/releases/latest/download/aipilot-cli-linux-amd64) |
| Linux | arm64 | [aipilot-cli-linux-arm64](https://github.com/softwarity/aipilot-cli/releases/latest/download/aipilot-cli-linux-arm64) |
| macOS | Intel | [aipilot-cli-macos-amd64](https://github.com/softwarity/aipilot-cli/releases/latest/download/aipilot-cli-macos-amd64) |
| macOS | Apple Silicon| [aipilot-cli-macos-arm64](https://github.com/softwarity/aipilot-cli/releases/latest/download/aipilot-cli-macos-arm64) |
| Windows | amd64 | [aipilot-cli-windows-amd64.exe](https://github.com/softwarity/aipilot-cli/releases/latest/download/aipilot-cli-windows-amd64.exe) |
After downloading, make it executable (Linux/macOS):
```bash
chmod +x aipilot-cli-*
mv aipilot-cli-* ~/.local/bin/aipilot-cli
```
### Build from source
```bash
git clone https://github.com/softwarity/aipilot-cli.git
cd aipilot-cli
go build -o aipilot-cli .
```
## Usage
```bash
# Default: auto-detects or prompts for agent selection
aipilot-cli
# Specify agent to run
aipilot-cli --agent claude
aipilot-cli --agent gemini
aipilot-cli --agent codex
# Specify working directory
aipilot-cli --workdir /path/to/project
# List available agents
aipilot-cli --agents
# Force agent re-selection (ignore saved preference)
aipilot-cli --select
# Manage sessions
aipilot-cli --sessions # List saved sessions
aipilot-cli --kill-sessions # Kill all sessions
# Check for updates
aipilot-cli --update
```
## Mobile App Features
The AIPilot mobile app provides:
- **Voice Recognition**: Dictate commands instead of typing
- **Multi-sessions**: Manage multiple projects simultaneously
- **Full Terminal**: Access all agent commands
- **File Sharing**: Share photos and documents with your agent
- **Session History**: Quickly reconnect to previous sessions
- **SSH Mode**: Connect directly to remote servers (Pro feature)
### Free vs Pro
| Feature | Free | Pro |
|---------|------|-----|
| CLI connections | 1 | Unlimited |
| SSH connections | - | Unlimited |
| Agents | - | Unlimited |
| File upload | - | ✓ |
## License
MIT - see [LICENSE](LICENSE)
---
Made with ❤️ by [Softwarity](https://softwarity.io)