터미널에서 쓰는 Auxo
GUI 없이 CLI만으로 에이전트를 만들고, 대화하고, 메신저에 연결합니다. 기억·능력·정직 계층은 앱과 같은 엔진으로 동작합니다.
설치
Node.js가 설치돼 있어야 합니다. 저장소를 받아 아래처럼 설치하면 끝입니다.
$ git clone https://github.com/getauxo/auxo-app.git
$ cd auxo-app
$ npm install --omit=dev
런타임 의존성은 네 개뿐입니다. Node.js v22에서 동작을 확인했습니다.
첫 실행
에이전트가 없으면 CLI가 알아서 만들기 시작합니다. 이름을 짓고 AI 모델을 고르면 곧바로 대화할 수 있습니다.
╭──────────────────────────────────────────────╮
│ ✦ Auxo CLI — 나만의 독립 에이전트 공간 │
│ │
│ 데이터 ~/.auxo-cli/auxo.db │
│ 팁 /help 로 명령 보기 · /agents 로 전환 │
╰──────────────────────────────────────────────╯
아직 에이전트가 없어요. 새로 만들어요.
── 새 에이전트 만들기 ── (취소: /cancel)
이름: 루나
AI 선택: 1
npm run cli 대신 node cli.js를 직접 실행해도 같습니다.
최신 버전으로 바꾸기
새 버전이 나오면 시작할 때 물어봅니다. 엔터만 누르시면 알아서 받아서 준비까지 끝내고, 다시 시작하면 새 버전으로 켜집니다.
v0.2.23 으로 지금 바꿀까요? (Enter=예 / n=나중에)
대화를 시작하기 전에만 물어봅니다. 이야기하는 도중에 끼어들지 않습니다. 대화와 기억은 ~/.auxo-cli에 따로 있어 이 과정에서 사라지지 않습니다.
직접 하고 싶으시거나 자동으로 안 될 때는 아래 두 줄이면 됩니다.
$ npm install --omit=dev
AI 모델 고르기
일곱 가지 중에 고릅니다. 크게 API 키를 넣는 방식과 이미 쓰는 구독을 그대로 쓰는 방식으로 나뉩니다. 나중에 언제든 바꿀 수 있고, 모델을 바꿔도 기억과 성격은 그대로 남습니다.
API 키를 넣으면 그 키로 쓸 수 있는 모델 목록을 받아 번호로 고릅니다. 모델 이름을 미리 알 필요는 없고, 검색어를 입력해 좁힐 수도 있습니다. 구독으로 연결한 경우에는 모델을 고르지 않습니다.
| 선택지 | 필요한 것 |
|---|---|
| Gemini API | Google AI Studio 키 (무료 발급 가능) |
| Claude API | Anthropic 키 (sk-ant-) |
| GPT (OpenAI) API | OpenAI 키 (sk-) |
| 기타 (OpenAI 호환) | 키 + baseURL — OpenRouter·DeepSeek 등 |
| Claude 구독 | 이 PC에 claude CLI 설치·로그인 |
| Codex 구독 | 이 PC에 codex CLI 설치·로그인 (ChatGPT) |
이미 쓰고 있는 Claude·ChatGPT 구독이 있다면, 해당 CLI가 이 컴퓨터에 설치돼 로그인된 상태이기만 하면 됩니다. Auxo가 그 CLI를 통해 대화합니다.
명령어
대화 중 아무 때나 /로 시작하는 명령을 입력할 수 있습니다. 나머지 입력은 전부 에이전트에게 가는 말입니다.
| 명령 | 하는 일 |
|---|---|
/help | 명령 목록 보기 |
/new | 새 에이전트 만들기 |
/agents | 에이전트 전환 |
/telegram | 텔레그램 메신저로 연결 |
/discord | 디스코드로 연결 (DM) |
/trust | 도구 사용 자율도 설정 (승인 정도) |
/notice on|off | 공지·업데이트 확인 켜기/끄기 |
/attach <경로> [메시지] | 파일 첨부해서 보내기 |
/clear | 화면 깨끗이 (대화·기억은 그대로) |
/exit | 끝내기 (저장됨) |
에이전트를 만드는 도중이거나 마법사가 떠 있을 때는 /cancel로 빠져나올 수 있습니다.
자율도 설정
에이전트가 파일을 만들거나 바꾸는 등 실제 변경을 일으킬 때, 어디까지 먼저 확인할지 정합니다. /trust로 언제든 바꿀 수 있습니다.
| 단계 | 동작 |
|---|---|
ask_all | 매번 물어봄 — 모든 변경 작업에 확인 |
ask_risky | 기본값 — 위험 작업만 확인 (쓰기·삭제 등) |
autonomous | 알아서 진행 — 확인 없이 바로 실행 |
대화 중에 "앞으로 묻지 말고 알아서 해"처럼 말해도 에이전트가 이 설정을 바꿉니다. 반대로 "이번만 허락"은 설정을 건드리지 않고 그 작업만 진행합니다.
메신저 연결
/telegram 또는 /discord를 실행하면 마법사가 안내합니다. 연결해두면 폰에서도 같은 에이전트와 이야기할 수 있고, 기억도 이어집니다.
메신저 연결은 이 컴퓨터에서 도는 로컬 폴링 방식입니다. CLI(또는 앱)를 종료하면 메신저에서 말을 걸어도 대답하지 않습니다. 서버에 상주하는 봇이 아닙니다.
다음 실행부터는 연결이 자동으로 복원됩니다. 텔레그램은 봇 토큰이, 디스코드는 봇 토큰과 Message Content Intent 설정이 필요합니다.
데이터는 어디에
모든 것이 내 컴퓨터에 저장됩니다. 우리 서버로 올라가는 것은 없습니다.
~/.auxo-cli/auxo.db
# 위치를 바꾸고 싶다면
$ AUXO_CLI_DATA=/path/to/dir npm run cli
저장은 로컬이지만, 답변을 생성하려면 대화 내용이 여러분이 고른 모델 제공자(Google·Anthropic·OpenAI 등)로 전송됩니다.
앱과 무엇이 다른가
CLI는 데스크톱 앱과 완전히 분리된 독립 공간입니다. 같은 이름을 지어줘도 앱의 에이전트와 CLI의 에이전트는 서로의 기억을 모릅니다.
| 데스크톱 앱 | CLI | |
|---|---|---|
| 에이전트 수 | 하나 | 여럿 (/agents로 전환) |
| 데이터 위치 | 앱 사용자 폴더 | ~/.auxo-cli |
| 기억 공유 | 공유하지 않습니다 — 서로 별개입니다 | |
| 스킬·MCP | 능력 화면에서 관리 | 대화로 부탁하면 찾아서 설치 |
| 기억·능력·정직 계층 | 같은 엔진으로 동일하게 동작합니다 | |
스킬과 MCP를 고르고 지우는 관리 화면은 앱에만 있습니다. CLI에서는 "○○ 할 수 있는 도구 붙여줘"처럼 대화로 부탁하면 에이전트가 카탈로그에서 찾아 설치를 제안합니다.