saadnvd1/agent-os

AI 코딩 세션을 관리하기 위한 모바일 우선 (Mobile-first) 웹 UI.

agent-os-mobile-demo.mp4

이미 Node.js 20+ 버전이 설치되어 있는 경우:

# 전역(globally) 설치
npm install -g @saadnvd1/agent-os
# 설정 실행 (tmux, ripgrep 확인/설치 및 앱 빌드)
...

Node.js가 없는 상태의 신규 설치의 경우:

curl -fsSL https://raw.githubusercontent.com/saadnvd1/agent-os/main/scripts/install.sh | bash
agent-os start

Releases에서 네이티브 데스크톱 앱을 다운로드하세요:

• macOS (Apple Silicon):
  .dmg

• Linux:
  .deb

또는 .AppImage

참고: 데스크톱 앱은 웹 UI를 감싸는 네이티브 래퍼 (native wrapper)입니다. 백엔드 서버를 위해 여전히 AgentOS를 (위의 설치 스크립트를 통해) 설치하고 실행해야 합니다. 데스크톱 앱은 브라우저를 사용하는 대신 편리한 네이티브 창을 제공할 뿐입니다.

직접 호스팅(self-host)하고 싶지 않으신가요? AI 코딩을 위해 사전 구성된 클라우드 VM을 제공하는 AgentOS Cloud를 사용해 보세요.

git clone https://github.com/saadnvd1/agent-os
cd agent-os
npm install
...

• Node.js 20+
• tmux
• ripgrep (코드 검색용 - 설치 스크립트에 의해 자동 설치되거나, agent-os update 실행)
• 최소 하나 이상의 AI CLI: Claude Code, Codex, OpenCode, Gemini CLI, Aider, 또는 Cursor CLI

Agent	Resume	Fork	Auto-Approve
Claude Code	✅	✅	--dangerously-skip-permissions
...

모바일 우선 (Mobile-first) - 기능이 축소된 반응형 뷰가 아닌, 휴대폰에서 모든 기능을 사용할 수 있음
음성-텍스트 변환 (Voice-to-text) - 코딩 세션에 프롬프트를 핸즈프리로 받아쓰기
멀티 페인 레이아웃 (Multi-pane layout) - 최대 4개의 세션을 나란히 실행
코드 검색 (Code search) - 구문 강조(syntax-highlighted)된 결과와 함께 빠른 코드베이스 검색 (Cmd+K)
파일 피커 (File picker) - 세션에 파일을 찾아 첨부할 수 있으며, 모바일에서 직접 업로드 가능
GitHub에서 클론 (Clone from GitHub) - 프로젝트 생성 시 UI에서 직접 저장소(repos)를 클론
Git 통합 (Git integration) - UI에서 상태, 차이점(diffs), 커밋(commits), PR 확인 가능
Git 워크트리 (Git worktrees) - 자동 설정 기능이 포함된 격리된 브랜치
개발 서버 (Dev servers) - Node.js 및 Docker 서버 시작/중지
세션 오케스트레이션 (Session orchestration) - MCP를 통한 지휘자/작업자 (Conductor/worker) 모델

agent-os run # 실행 및 브라우저 열기
agent-os start # 백그라운드에서 실행
agent-os stop # 서버 중지
...

휴대폰에서 보안 접속을 위해 Tailscale을 사용하세요:

• 개발용 머신과 휴대폰에 Tailscale을 설치합니다.
• 동일한 계정으로 로그인합니다.
• 휴대폰에서 http://100.x.x.x:3011로 접속합니다.

설정 및 고급 사용법은 문서를 참조하세요.

aTerm - AI 지원 코딩을 위한 Tauri 기반의 데스크톱 터미널 워크스페이스입니다. AgentOS가 모바일 우선의 웹 UI라면, aTerm은 셸(Shell), 개발 서버(Dev server), 그리고 내장된 git 패널과 함께 AI 코딩 에이전트(Claude Code, Aider, OpenCode)를 실행하는 데 최적화된 멀티 페인 레이아웃(Multi-pane layouts)을 갖춘 네이티브 데스크톱 앱입니다. 모바일 접속 및 브라우저 기반 워크플로우를 원한다면 AgentOS를, 네이티브 데스크톱 터미널 경험을 원한다면 aTerm을 선택하세요.

LumifyHub - 실시간 채팅과 구조화된 문서화 기능을 갖춘 팀 협업 플랫폼입니다. 팀 전체에 걸쳐 멀티 에이전트(Multi-agent) 작업을 조정할 때 AgentOS와 함께 사용하면 유용합니다. 세션 컨텍스트(Session context)를 공유하고, 코딩 세션으로부터 아키텍처 결정 사항을 문서화하며, 병렬적인 에이전트 워크플로우(Agent workflows)의 진행 상황을 추적할 수 있습니다.

MIT License - 무료 및 오픈 소스입니다.

전체 약관은 LICENSE를 참조하세요.