TerminAI

터미널에서 사용할 수 있는 안전하고 로컬 우선의 AI 오퍼레이터입니다.

ChatGPT에서 복사-붙여넣기 하는 것을 멈추세요. TerminAI는 사용자가 통제하는 권한으로 시스템을 조작하는 CLI(Command Line Interface)입니다.

사용자가 이미 신뢰하는 모델(Gemini, OpenAI, 로컬 LLM)을 사용하여 Windows/Linux/macOS에서 실행됩니다. 관리되고, 검토 가능하며, 되돌릴 수 있는 방식으로 실제 시스템 변경이나 사용자 워크플로우를 위해 설계되었습니다.

TerminAI는 AI 기반 시스템 오퍼레이터입니다. 사용자가 원하는 것을 설명하면, TerminAI가 사용자의 기기를 검사하고, **관리되는 도구(governed tools)**를 통해 결정론적인 **승인 단계(approval ladder)**와 **감사 추적(audit trail)**을 거쳐 계획을 제안하고 실행합니다.

상태: Public Preview (v0.x)
핵심 오퍼레이터 루프는 매우 안정적입니다. CLI가 표준 인터페이스입니다.
데스크톱/음성/A2A(Application-to-Application) 기능은 선택 사항이며 플랫폼 전반에 걸쳐 아직 강화되는 중입니다.
강력한 기능을 기대하세요; 다듬어지지 않은 부분도 예상해야 합니다. 기여를 환영합니다.

이것이 무엇이고 / 이것이 아닌 것

이것은:

• 의도(intent) → 관리되는 계획(governed plan) → 승인(approvals) → 실행(execution) → 감사 로그(audit log)로 이어지는 로컬 우선 오퍼레이터 런타임입니다.
• 실제 터미널 오퍼레이터 (진정한 PTY): 대화형 세션(sudo 프롬프트, ssh, vim/htop 스타일의 흐름)을 처리할 수 있습니다.
• 모델 유연성 설정: 이미 사용하고 있는 제공업체(OpenAI와 호환되는 엔드포인트 및 로컬 게이트웨이 포함)를 선택할 수 있습니다.
• 원한다면 100% 무료이고 100% 개인 정보 보호가 가능합니다. OpenRouter에서 무료 모델을 사용하거나, 로컬 LLM을 실행하세요—텔레메트리도 없고, 요금 청구도 없습니다, 영원히요.

이것은 아닙니다:

• 호스팅 서비스입니다. '영업 문의', 파일럿 프로그램, 관리형 배포 또는 지원 의무가 없으며, 최선을 다하는 OSS(Open Source Software)입니다.
• 명령을 조용히 실행하는 '검증되지 않은 에이전트'입니다. 위험한 작업은 명시적인 승인 절차를 거치고 로컬에 기록됩니다.
• 모든 기능이 오늘날 프로덕션 수준으로 강화될 것이라는 약속(데스크톱/음성/원격 기능은 선택적 미리보기입니다).

데모 (Demo)

지금 바로 사용해 보기 (Try it right now) (10분)

다음 프롬프트 중 하나를 선택하여 TerminAI에 붙여넣으세요. (전체 프롬프트를 복사하려면 클릭하세요)

"다음 주 토요일에 관광 목적으로 파리를 방문할 일정표를 짜주세요. 이미 주요 명소(에펠탑, 루브르 박물관)는 봤어요. 숨겨진 보석 같은 장소를 찾아주고, 레스토랑까지 포함해서 시간대별로 여행 계획을 세워주세요. 지도에 표시해 주세요. 모든 장소는 지하철을 이용할 거예요. 완료되면 이 지도 기반의 시각적 결과물을 PDF 파일로 저장해 주세요."

"최근 OS 업데이트 이후 그래픽 드라이버가 불안정한 것 같아요. 제 GPU 모델을 식별하고, 현재 설치된 드라이버 버전을 확인한 다음, 올바른 최신 안정화 드라이버를 찾아주세요. 클린 설치 계획을 제안하고 실행 전에 검증해 주세요."

"10분마다 비트코인 가격을 확인해 주세요. 만약 $90,000 이하로 떨어지면 시스템 알림을 보내고, 타임스탬프/가격 정보를 ~/crypto_log.csv 파일에 추가해 주세요. 제가 중단할 때까지 이 작업을 백그라운드에서 계속 실행해 주세요."

비전 (Vision)

컴퓨터가 안전하게 당신을 위해 무언가를 할 수 있다면 어떨까요?

단순히 명령을 제안하는 것을 넘어. 단순한 스크립트를 생성하는 것도 아닙니다. 실제로 시스템을 운영합니다—문제를 진단하고, 문제를 해결하며, 워크플로우를 조율합니다—실행이 신뢰할 수 있도록 하는 가드레일(guardrails)과 함께 말입니다.

수년 동안 '인터넷 도움'이란: 채팅창에서 지침을 복사하여 터미널에 붙여넣고, 단계를 놓치지 않았기를 바라는 것을 의미했습니다. 코딩 도구들(Cursor, Aider 등)은 소프트웨어 개발의 마찰을 줄였지만—컴퓨터의 나머지 부분은 여전히 복사/붙여넣기 시대에 갇혀 있습니다.

TerminAI는 다음 인터페이스입니다: 사용자가 의도(intent)를 진술하면, 시스템이 통제된 계획을 제안하고, 사용자가 적절한 수준에서 승인하며, 감사 추적(audit trail)과 함께 실행합니다. 더 적은 불안정한 단계. 그리고 검증되지 않은 에이전트에게 기계를 맡기지 않고도 더 많은 결과물을 얻습니다.

왜 이것이 존재하는가

컴퓨터는 강력하지만, 이를 운영하기 위해서는 여전히 구문을 암기하고, 로그를 뒤지고, 동일한 진단 단계를 반복해야 합니다.

TerminAI는 **의도(intent)**와 실행(execution) 사이의 간극을 압축합니다—사용자의 기계를 통제되지 않는 '에이전트'로 만들지 않으면서 말입니다.

의도 → 통제된 계획 → 승인 → 실행 → 감사

누가 이것을 위한 것인가

• 일반 사용자(Generalist users) — “다운로드 폴더에서 가장 큰 파일을 검토해 줘. 가장 오래된 것부터 우선순위를 지정해서, 공간을 200 GB 확보해야 해.” “인터넷에 문제가 있어; 어댑터를 초기화해 줘.” “HP 프린터를 설정해 줘.” "NVDA의 주가를 모니터링하고 xx$에 도달하면 알려줘." "시스템이 왜 이렇게 느려? 메모리를 확보할 수 있니?" "내 리눅스 머신에서 최고의 마크다운 뷰어를 설치해 줄래?". "방금 Windows를 재설치했어. 내 GPU 전용 드라이버를 찾아서 설치해 줘".
• 개발자(Developers) — “이 레포지토리(repo)에 맞게 내 환경을 설정해 줘.” “내 개발 환경을 수정해 줘.” “무엇이 고장 났고 어떻게 복구해야 하는지 설명해 줘.” "이 프로젝트의 모든 종속성(dependencies)을 설치해 줘"
• 기술 전문가(Tech purists) — 결정론적 가드레일(deterministic guardrails), 명시적 승인(explicit approvals), 그리고 변조 방지 로그(tamper-evident logs)를 활용한 AI 기능.
• 전문 엔지니어/DevOps — 서버 원격 제어, 반복 가능한 워크플로우, 헤드리스 환경에 적합한 CLI (Command Line Interface), 안전한 실행, 읽기 쉬운 감사 추적 기록(audit trails).

TerminAI 사용 방법 두 가지

• CLI (표준 방식/canonical): 개발자, 파워 유저 및 헤드리스 환경용.
• 데스크톱 (미리 보기/preview): 동일 엔진을 기반으로 한 Tauri 래퍼(wrapper)입니다 (GUI + 음성 인터페이스). 리눅스/윈도우가 초기 버전이며, macOS는 현재 개발 중입니다. 안정화될 때까지 실험적인 기능으로 간주하세요.

표준 명령어는 다음과 같습니다: terminai.

TerminAI가 다른 점

AI 시스템의 작동은 반드시 통제되어야 합니다. TerminAI는 바로 그 기본 원리(primitive)를 중심으로 구축되었습니다.

• 진정한 PTY 지원: node-pty를 통해 대화형 애플리케이션(sudo 프롬프트, ssh 세션, vim/htop과 같은 흐름)을 올바르게 처리합니다.
• 제어된 자율성: 엄격한 **정책 엔진 (policy engine)**과 결정론적 승인 단계 (approval ladder) (A/B/C)가 "무모한 실행(yolo execution)"을 대체합니다.
• 기본 감사 추적 (Audit trail): 수행된 작업 및 의도 추적을 위한 구조화된 JSONL 로그를 제공하며, 이는 로컬 파일로 검토하거나 재실행할 수 있습니다.
• 공급자 유연성: 이미 사용하고 있는 것을 선택할 수 있습니다—Google, OpenAI 로그인 또는 모든 OpenAI 호환 /chat/completions 엔드포인트 (OpenRouter, 로컬 게이트웨이 등).
• 깊은 확장성: MCP (도구 커넥터)에 대한 1급 지원과 선택적 에이전트 간 (Agent-to-Agent, A2A) 제어 평면(미리 보기)을 제공합니다.
• 로컬 우선 자세 (Local-first posture): 핵심 작동은 사용자의 기기에서 실행되며, 호스팅되는 릴레이가 필요하지 않습니다. 선택적인 원격 기능은 옵트인 방식이며 사용자의 통제 하에 있습니다.

더 읽어보기: docs-terminai/why-terminai.md

설치 (Install)

CLI (npm)

선행 조건: Node.js 20+

npm i -g @terminai/cli
terminai --version
terminai

아직 CLI 패키지가 보이지 않거나(또는 최신 기능을 원한다면), 아래에서 소스 코드로 설치하세요.

데스크톱 (설치 프로그램) — 미리 보기

GitHub Releases에서 설치 프로그램을 다운로드하세요 (데스크톱 버전은 미리 보기 상태입니다):

• https://github.com/Prof-Harita/terminaI/releases

Git 클론 및 빌드 (기여자 / 최신 기능)

git clone https://github.com/Prof-Harita/terminaI.git
cd terminaI
npm install
...

업그레이드 (이전에 설치한 경우)

최근의 다중 공급자 업데이트 이전에 설치했다면, 최신 인증 및 플랫폼 동기화를 위해 업그레이드하세요.

• npm 전역:
  복사

  npm i -g @terminai/cli@latest
  terminai --version
  

  1

  2

  3
• 릴리스 설치 프로그램: Releases에서 최신 버전을 받아 다시 설치하세요:
  • https://github.com/Prof-Harita/terminaI/releases
• 소스 빌드:
  복사

  git pull
  npm install
  npm run build
  

  1

  2

  3

  4

빠른 시작 (Quick start) (공급자)

terminai를 실행하고 마법사(wizard)의 안내에 따라 설정을 진행하세요.

Google Gemini (기본값)

많은 사용자에게 가장 빠른 경로입니다.

terminai
# "Google Gemini" 선택 → 브라우저 열림 → 로그인

또는 API 키를 사용합니다:

# macOS/Linux
export TERMINAI_API_KEY="your-gemini-key"

...

ChatGPT 로그인 (OAuth) — 미리보기

OpenAI 브라우저 로그인 플로우(Codex 툴링이 "ChatGPT로 로그인"을 지원하는 방식과 유사함)를 사용합니다.

terminai
# "ChatGPT Sign-in (OAuth)" 선택 → OpenAI로 로그인

참고: 이 기능은 아직 안정화 단계에 있습니다. 문제가 발생하면 로그를 첨부(아래 참조)하고 이슈를 제기해 주세요.

OpenAI 호환

OpenAI Platform, OpenRouter, Ollama 게이트웨이 또는 모든 /chat/completions 엔드포인트에 연결할 수 있습니다.

# macOS/Linux
export OPENAI_API_KEY="sk-..."

...

인기 사용 설정:

• OpenAI: https://api.openai.com/v1
• OpenRouter: https://openrouter.ai/api/v1
• 로컬 LLM 게이트웨이: http://localhost:11434/v1

자세히 보기: docs-terminai/multi-llm-support.md

내부에서 전환하려면 `/llm reset`을 사용하세요. 현재는 핫 스왑(hot-swap)이 완전히 지원되지 않습니다. 변경 사항을 적용하려면 재시작(Ctrl-C 후 npm run start 또는 terminai 실행)해 주세요.

The Sovereign Runtime (안전 및 아키텍처)

TerminAI는 **3중 방어 심층 모델(3-Layer Defense-in-Depth)**을 기반으로 작동하여, 자율적인 실행이 결코 "무제한 접근"이 되지 않도록 보장합니다:

1. **인지 계층 (The

구조적 주권(Structural Sovereignty): 설계 단계부터 원격 측정(telemetry)을 배제합니다. 옵트인(opt-in)도, 옵트아웃(opt-out)도 없습니다. 오직 검사할 수 있는 로컬 로그만 존재합니다. 사용자가 선택한 LLM 제공업체를 제외하고는 아무것도 시스템 외부로 나가지 않습니다.

문서화 (Documentation)

여기서 시작하세요:

• docs-terminai/quickstart.md
• docs-terminai/configuration.md
• docs-terminai/troubleshooting.md
• docs-terminai/voice.md
• docs-terminai/multi-llm-support.md

기여자 및 보안 참고 자료:

• AGENTS.md
• CONTRIBUTING.md
• SECURITY.md

packages/
├── core/           # 엔진: 도구(tools), 정책(policy), 라우팅(routing), 로깅/원격 측정(logging/telemetry) (옵트인)
├── cli/            # 터미널 UI (Ink/React)
...

사전 요구 사항 (Prereqs):

• Node.js 20+
• Rust (최신 안정 버전) 데스크톱 빌드를 위해
• 플랫폼별 빌드 도구 (아래 참조)

첫 사용 설정 (의존성을 자동 설치):

npm ci
npm run setup:dev

이 명령어는 OS를 감지하여 필요한 빌드 도구를 설치합니다:

• Windows: Visual Studio Build Tools (C++ 워크로드), WebView2
• Linux: build-essential, webkit2gtk, libappindicator, librsvg
• macOS: Xcode Command Line Tools

소스에서 CLI를 빌드하고 실행합니다:

npm run build
npm start

데스크톱 개발:

npm run desktop:dev
# 또는: cd packages/desktop && npm run tauri dev

TerminAI vs. “채팅 우선(chat-first)” 컴퓨터 비서의 차이점?

계보 (Lineage)

TerminAI는 Google의 Gemini CLI의 오픈 소스 발전 형태입니다:

라이선스 및 상표권

• 라이선스: Apache-2.0 (자세한 내용은 LICENSE 참조)
• 상표권: TRADEMARK.md 참조