termly-dev/termly-cli

어떤 기기에서든 AI 코딩 어시스턴트(AI coding assistants)에 접속하세요. Claude Code, Aider, GitHub Copilot 및 모든 터미널 기반 AI 도구와 함께 작동합니다.

🐼
Qwen Code- Qwen3-Coder 모델에 최적화된 Alibaba의 에이전틱 코딩 CLI (agentic coding CLI) 지원 추가 - 🔒
Security (보안)- 8개의 Dependabot 경고 패치 완료 (axios, lodash, ajv, follow-redirects)

이전 버전:

v1.9.3- 재연결 시 서버로부터의 pairing_expired 오류 처리
v1.9- Pi Coding Agent, Kilo Code CLI, 향상된 TUI 모드
v1.8- Pi Coding Agent 및 Kilo Code CLI 지원 추가
v1.7- TUI 모드 지원, OpenCode 통합, 더 스마트한 재연결
v1.5- 푸시 알림 (Push notifications) 지원, 세션 안정성 개선
v1.3- 사전 빌드된 바이너리 (Prebuilt binaries), Windows 지원 개선, 빠른 설치
v1.2- Windows 출력 중복 제거 및 PowerShell 최적화
v1.0- 세션 관리 및 종단간 암호화 (E2EE)를 포함한 안정적인 릴리스

🚀
범용 AI 도구 지원 (Universal AI Tool Support)- 모든 터미널 기반 AI 코딩 어시스턴트와 작동 - 📱
모바일 접속 (Mobile Access)- 휴대폰이나 태블릿에서 AI 도구를 제어 - 🔒
종단간 암호화 (End-to-End Encryption)- 지문 검증 (fingerprint verification)을 포함한 AES-256-GCM + DH-2048 키 교환 - 🔄
세션 재개 (Session Resume)- 상태 동기화(state synchronization)를 통한 자동 재연결 - 💻
다중 세션 (Multiple Sessions)- 여러 AI 도구를 동시에 실행 - 🎯
자동 감지 (Auto-Detection)- 설치된 AI 도구를 자동으로 찾음 - ⚡
제로 지식 서버 (Zero-Knowledge Server)- 서버는 사용자의 암호화되지 않은 데이터를 절대 볼 수 없음 - 🌍
다중 환경 (Multiple Environments)- 운영(Production), 개발(Development), 로컬(Local) 모드 - 🔄
자동 업데이트 확인 (Auto-Update Check)- 항상 지원되는 버전을 실행하도록 보장

Termly CLI는 모든 플랫폼을 위한 **사전 빌드된 바이너리 (prebuilt binaries)**를 포함하고 있어 컴파일이 필요하지 않습니다!

모든 플랫폼:

npm install -g @termly-dev/cli

설치 후, termly 명령어를 전역적으로 사용할 수 있습니다.

그게 전부입니다! 다음 환경에서 즉시 작동합니다:

✅ macOS (Intel & Apple Silicon)
✅ Linux (x64 & ARM64)
✅ Windows 10+ (x64 & ARM64)

베타 테스터 및 개발용:

npm install -g @termly-dev/cli-dev

이 명령은 termly-dev를 설치합니다.

개발 환경에 연결하는 명령입니다.

Node.js 18+ - 이것만 있으면 됩니다!

Termly CLI는 모든 플랫폼을 위한 사전 빌드된 바이너리(prebuilt binaries)가 포함된 @lydell/node-pty를 사용합니다:

Windows에서 Visual Studio 불필요
macOS에서 Xcode CLI 도구 불필요
Linux에서 build-essential 불필요
빠른 설치(컴파일 과정 없음)

설치는 보통 10-30초 내에 완료됩니다.

Termly CLI는 세 가지 환경을 지원합니다:

환경	패키지	명령	서버 URL	사용 사례
Production (운영)	`@termly-dev/cli`	`termly`	`wss://api.termly.dev`	최종 사용자
Development (개발)	`@termly-dev/cli-dev`	`termly-dev`	`wss://dev-api.termly.dev`	베타 테스터
Local (로컬)	소스에서 실행	`TERMLY_ENV=local termly`	`ws://localhost:3000`	개발자 전용

참고: 서버 URL은 환경별로 하드코딩되어 있으며 사용자가 변경할 수 없습니다.

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
...

여러 세션을 동시에 실행하기:

# 터미널 1
cd ~/frontend
termly start
...

각 세션은 다음과 같습니다:

독립적인 AI 도구 인스턴스
고유한 WebSocket 연결
모바일 기기 1대 연결 가능

세션 관리:

termly status # 모든 세션 표시
termly stop abc-123 # 특정 세션 중지
termly list # 빠른 목록 확인

Termly CLI는 **23개 이상의 대화형 터미널 기반 AI 코딩 어시스턴트 (AI coding assistants)**를 지원합니다:

Claude Code(Anthropic) - AI 코딩 어시스턴트
GitHub Copilot CLI(Microsoft) - 커맨드 라인 AI
Cursor CLI(Cursor) - AI 코딩 어시스턴트 CLI
Cody CLI(Sourcegraph) - AI 어시스턴트 (Beta)
Amazon Q Developer(AWS) - 무료 티어 사용 가능
Google Gemini CLI(Google) - 1M 토큰 컨텍스트 윈도우 (context window)
Grok CLI(xAI) - X.AI의 코딩 어시스턴트
OpenAI Codex CLI(OpenAI) - 코드 생성 모델
Qwen Code(Alibaba) - Qwen3-Coder 모델에 최적화된 에이전틱 (Agentic) 코딩 CLI

Aider - AI 페어 프로그래밍 (35k+ stars)
OpenCode - LSP 통합 기반의 TUI 기반 AI 코딩 에이전트 (전체 TUI 지원!)
Kilo Code CLI - 500개 이상의 모델과 병렬 모드를 지원하는 에이전틱 (Agentic) 엔지니어링 CLI (전체 TUI 지원!)
Pi Coding Agent - 확장 기능, 기술(skills) 및 15개 이상의 LLM 제공업체를 갖춘 미니멀 AI 에이전트
Continue CLI - 모듈형 아키텍처 (Modular architecture)
OpenHands - 오픈 소스 Devin 대안
Mentat - Git 통합
ChatGPT CLI - 터미널 내의 ChatGPT
ShellGPT - 셸 명령 어시스턴트 (Shell command assistant)
Ollama - LLM을 로컬에서 실행 (CodeLlama 등)
Blackbox AI - 디버깅 (Debugging) 및 파일 편집

Devin CLI - 출시 시 지원 예정
기타 모든 터미널 기반 AI 도구

기타... - 대화형 TTY 모드를 지원하는 모든 터미널 기반 AI 도구와 함께 작동합니다.

모든 명령은 termly (production) 및 termly-dev (development) 모두에서 동일한 방식으로 작동합니다.

termly setup

대화형 설정 구축 (선택 사항 - 기본 AI 도구 선호도 설정).

termly start [directory] [options]

AI 도구와 함께 새로운 세션을 시작합니다.

옵션:

--ai <tool>

사용할 AI 도구 지정
--ai-args <args>
AI 도구를 위한 추가 인자 (arguments)
--no-auto-detect
자동 감지 비활성화
--debug
디버그 로깅 (debug logging) 활성화

예시:

# 자동 감지 및 시작
termly start
# Aider를 명시적으로 사용
...

termly status [--all]

상세 정보와 함께 모든 활성 세션을 표시합니다.

termly stop [session-id] [--all]

하나 또는 모든 세션을 중지합니다.

termly list

검증을 위한 암호화 지문 (encryption fingerprints)이 포함된 활성 세션의 빠른 목록을 표시합니다.

termly tools list # 사용 가능한 AI 도구 목록
termly tools detect # 설치된 도구 감지
termly tools info <tool> # 도구 정보 표시

termly config # 현재 설정 표시
termly config get <key> # 설정 값 가져오기
termly config set <key> <value> # 설정 값 설정

예시:

termly config set defaultAI aider
termly config get defaultAI

참고: 서버 URL은 환경에 의해 결정되며 설정을 통해 변경할 수 없습니다.

termly cleanup

오래된 세션(더 이상 실행 중이지 않은 프로세스)을 제거합니다.

Node.js 18 이상****최소 하나 이상의 AI 코딩 어시스턴트 (AI coding assistant) 설치됨 (지원되는 AI 도구 섹션 참조)모바일 앱 (Mobile app) (iOS/Android) - 출시 예정

사전 빌드된 바이너리 (prebuilt binaries) 덕분에 설치는 보통 완벽하게 작동합니다.

문제가 발생할 경우:

"Cannot find module 'node-pty'"

패키지를 재설치하세요:

npm uninstall -g @termly-dev/cli
npm cache clean --force
npm install -g @termly-dev/cli

macOS/Linux에서의 권한 오류 (Permission errors)

sudo를 사용하거나:

npm 권한을 수정하세요:

# 옵션 1: sudo 사용
sudo npm install -g @termly-dev/cli
# 옵션 2: npm 권한 수정 (권장)
...

Windows: "EPERM: operation not permitted"

이는 대개 경고일 뿐, 치명적인 오류는 아닙니다. 설치가 성공했는지 확인하세요:

termly --version

명령어가 작동한다면 설치가 성공한 것입니다.

AI 도구가 감지되지 않나요?

termly tools list # 설치된 도구 확인

AI 도구를 설치하세요:

Claude Code: https://docs.claude.com
Aider:
pip install aider-chat
GitHub Copilot:
gh extension install github/gh-copilot

세션이 이미 실행 중인가요?

termly status # 세션 ID 찾기
termly stop abc-123 # 세션 중지

환경 확인:

termly config # 현재 환경 및 서버 URL 표시

로그 (Logs): ~/.termly/logs/cli.log

문제 보고: https://github.com/termly-dev/termly-cli/issues

종단간 암호화 (End-to-end encryption) (AES-256-GCM)
Diffie-Hellman 키 교환 (2048-bit)
지문 검증 (Fingerprint verification) - CLI와 모바일 앱 간의 암호화 키 비교
제로 지식 서버 (Zero-knowledge server) - 서버는 사용자의 데이터를 복호화할 수 없음
세션당 하나의 모바일 기기
환경 격리 (Environment isolation) - 프로덕션 (Production)과 개발 (Development) 분리
버전 강제 (Version enforcement) - 최소 지원 버전에 대한 자동 확인
오픈 소스 (Open source) - 코드를 직접 감사 가능

Termly CLI는 PTY (pseudo-terminal, 가상 터미널)를 사용하여 로컬에서 AI 도구를 생성하며, 종단간 암호화가 적용된 WebSocket을 통해 I/O를 스트리밍합니다.

Mobile App <--[encrypted]--> WebSocket Server <--[encrypted]--> CLI <--[local]--> PTY <--> AI Tool

주요 기능 (Key features):

순환 버퍼 (Circular buffer)- 세션 재개를 위해 마지막 100KB를 저장
플랫폼별 최적화 (Platform-specific optimizations)- Windows 출력 중복 제거 및 이스케이프 시퀀스 (escape sequence) 정규화
배치 캐치업 (Batch catchup)- 누락된 메시지를 10ms 지연과 함께 100개 메시지 단위의 배치 (batch)로 전송

상세한 아키텍처 다이어그램과 데이터 흐름은 docs/ARCHITECTURE.md를 참조하세요.

# 의존성 설치
npm install
# 프로덕션 모드 실행
...

# package.json 및 package.dev.json의 버전 업데이트
npm version patch # 또는 minor, 또는 major
# 프로덕션 패키지 게시
...

# publish 스크립트 사용
./scripts/publish-dev.sh
# 또는 수동으로:
...

기여(Contributions)를 환영합니다! 다음 절차를 따라주세요:

저장소 포크 (Fork)
기능 브랜치 생성 (git checkout -b feature/amazing-feature)
변경 사항 커밋 (git commit -m 'Add amazing feature')
브랜치에 푸시 (git push origin feature/amazing-feature)
풀 리퀘스트 (Pull Request) 생성

기여하기 전에:

프로젝트 구조와 구현 세부 사항은 CLAUDE.md를 읽어주세요
아키텍처 개요는 docs/ARCHITECTURE.md를 확인하세요
변경 사항을 테스트하기 위해 CLI를 로컬에서 실행하세요

CLAUDE.md- AI 어시스턴트를 위한 프로젝트 개요 및 구현 가이드
docs/ARCHITECTURE.md- 데이터 흐름 다이어그램이 포함된 상세 아키텍처
CRYPTO_SPEC.md- 종단간 암호화 (End-to-end encryption) 사양
COMMUNICATION_PROTOCOL.md- WebSocket 프로토콜 문서
WINDOWS_DEBUG.md- Windows 디버깅 지침
MIGRATION_TO_ESM.md- 향후 ESM 마이그레이션 계획

MIT - 자세한 내용은 LICENSE를 참조하세요

이슈 (Issues): https://github.com/termly-dev/termly-cli/issues
토론 (Discussions): https://github.com/termly-dev/termly-cli/discussions
웹사이트 (Website): https://termly.dev
문서 (Documentation): https://termly.dev/docs

🌐 웹사이트 (Website): https://termly.dev
🔧 개발 (Development): https://dev.termly.dev
📚 문서 (Documentation): https://termly.dev/docs
💻 GitHub: https://github.com/termly-dev/termly-cli
🐛 이슈 (Issues): https://github.com/termly-dev/termly-cli/issues
☕ 지원하기 (Support us): https://ko-fi.com/termly

Termly 팀이 ❤️로 제작했습니다.

termly-dev/termly-cli

요약

핵심 포인트

댓글