개발자가 실제로 작업하는 방식에 맞춰진 터미널 네이티브 AI 코딩 어시스턴트

aurict.com · npm · Docs · Changelog · Android APK

❯ aurict

Aurict는 전적으로 사용자의 터미널에서 실행됩니다. 웹 브라우저 탭도, Electron 오버헤드도, 창 간 클립보드 조작도 없습니다. 개발자가 코드를 작성하는 환경에 그대로 머무르면서 AI가 그곳에서 만납니다. 파일, 셸(shell), 언어 서버(language servers), 실행 중인 프로세스에 대한 완전한 접근 권한을 가지고 있습니다.

더 넓어진 Aurict 시스템에는 이제 공개 웹 표면(public web surface), BYOK 모바일 어시스턴트, 그리고 로컬 백엔드 제어 평면(local backend control-plane) 프로토타입이 포함됩니다. 터미널은 핵심 제품으로 남아 있으며, 웹 및 모바일 레이어는 인증, 문서화, 로드맵 가시성, 계정 삭제, 피드백 보고, Android 릴리스 배포, 그리고 미래 콘솔 워크플로우를 처리합니다.

대부분의 AI 코딩 도구는 우연히 코드 블록이 있는 채팅 인터페이스를 중심으로 구축됩니다. Aurict는 우연히 채팅 인터페이스가 있는 코딩 환경을 중심으로 구축되었습니다.

사용자가 말하기 전에 프로젝트를 이해합니다.
Aurict는 시작 시 저장소(repository) 전체를 스캔하여 프레임워크, 언어, 패키지 관리자, 설정 파일, 기존 컨벤션 등을 파악하고 이 컨텍스트를 모든 요청에 주입합니다. Next.js와 Tailwind, Drizzle을 사용한다고 설명할 필요가 없습니다. 이미 알고 있습니다.

시뮬레이션된 것이 아닌 실제 도구로 작동합니다.
모든 파일 읽기, 셸 명령어, 코드 편집은 타이핑되고 권한이 통제되는 도구 레이어(tool layer)를 통해 이루어집니다. 명령어는 실행 전에 안전(safe), 경고(warning), 위험(dangerous)으로 분류됩니다. 위험한 실행은 낮은 오버헤드의 정책 샌드박스(policy sandbox)에 의해 제한됩니다: 권한 게이트, 보호된 경로, 시간 초과(timeouts), 출력 제한, 감사 추적(audit trails). 사용자는 항상 무슨 일이 일어나고 왜 일어나는지 알 수 있습니다.

TUI 시작 시, Aurict는 현재 폴더에 프로젝트 자동(Project Auto) 기능을 활성화할지 묻습니다. '예'를 선택하면 경계가 지정된 write, edit, 및 apply_patch에 대한 반복적인 프롬프트가 제거됩니다.

해당 프로젝트에서 현재 세션 동안 수행할 수 있는 작업들입니다. 셸 명령어, 비밀 정보(secrets), 내부 상태(internal state), 프로젝트 외부의 경로, 위험한 작업, 광범위한 삭제 등은 여전히 직접적인 승인이 필요합니다.

병렬로 생각합니다 (It thinks in parallel, not in sequence).
모듈 리팩토링, 테스트 스위트 작성, 보안 감사와 같은 긴 작업들은 하위 작업으로 분해되어 코드, 검토(review), 테스트, 문서화(docs), 성능, 보안, 디버그, 분석(analytics), 탐색(explore) 등 전문화된 워커 에이전트 풀에 배포됩니다. 그 결과는 공유 컨텍스트로 흘러 들어옵니다.

사용자의 스택 언어를 구사합니다 (It speaks your stack's language).
218개 이상의 기술(skills)은 특정 프레임워크, 도구 및 패턴을 다룹니다. 여기서 '기술'이란 단순한 프롬프트 템플릿이 아니라, AI가 사용자의 특정 기술 조합에 대해 추론하는 방식을 형성하는 구조화된 컨텍스트 주입입니다.

방해되지 않습니다 (It stays out of your way).
TUI는 Ink(터미널용 React)를 기반으로 구축되었습니다. 깨끗하게 렌더링되고, 스크롤이 올바르게 작동하며, 넓은 출력을 처리하고, 사용자가 상호작용하지 않을 때는 뒤로 물러납니다. 깜빡임도 없고, 전체 화면을 점유하는 일도 없습니다.

로컬 API를 노출합니다 (It exposes a local API).
모든 세션은 bearer-token 인증을 통해 HTTP로 접근 가능합니다. 스크립트의 출력을 파이프하거나, CI에서 Aurict를 구동하거나, 자체 도구를 구축할 수 있습니다.

표면(Surface)	설명(Description)
터미널 CLI (Terminal CLI)	제공자 라우팅, 프로젝트 컨텍스트, 도구, 세션, 기술, MCP, 훅 및 로컬 API를 갖춘 주요 개발자 에이전트
웹 플랫폼 (Web platform)	랜딩 페이지, 문서(docs), 변경 로그(changelog), 로드맵, 선언문(manifesto), Firebase 기반 인증, 브라우저 로그인 흐름, 개인 정보 보호 정책, 이용 약관 및 계정 삭제 방향
모바일 앱 (Mobile app)	채팅, 리서치, 문서/PDF 워크플로우, 제공자 세션 및 어시스턴트 답변 보고를 위한 Flutter BYOK 어시스턴트
백엔드 프로토타입 (Backend prototype)	계정 삭제 및 피드백 보고 수집을 위한 로컬/비공개 제어 평면(control-plane) 경로; `.gitignore`에 의해 공개 레포지토리에서 제외됨

기능 (Feature)	설명 (Description)
Multi-agent orchestration	워커 스레드 격리(Worker thread isolation), 3+1 코디네이터 모델 (탐색(explore), 코드 작성(code), 검토(review), 전문화(specialist))
218+ Skills	자동 프로젝트 분석, 시작 시 프레임워크별 컨텍스트 주입(context injection)
Streaming responses	토큰 단위 스트리밍과 확장된 사고 모델을 위한 실시간 추론 표시(live reasoning display)
Session memory	전체 복원 기능이 있는 SQLite 기반 영구 대화 기록(persistent conversation history)
Context compaction	컨텍스트 오버플로우 전에 자동 요약, 설정 가능한 임계값(configurable thresholds)
Undo	파일 편집을 포함하여 마지막 N개 에이전트 단계 되돌리기(Roll back)

도구 (Tool)	설명 (Description)
`bash`	보수적인 안전/경고/위험 분류를 갖춘 셸 실행(Shell execution)
`read`	라인 범위 지원을 갖춘 파일 읽기(File reading)
`write`	원자적 파일 쓰기(Atomic file writes)
`edit`	diff 미리보기를 통한 정밀 문자열 교체 편집(Precise string-replace edits)
`glob`	30초 시간 초과 보호 기능을 갖춘 패턴 기반 파일 검색(Pattern-based file search)
`grep`	파일을 가로지르는 정규 표현식 검색(Regex search)
`webfetch`	자동 HTML 제거 기능이 있는 HTTP 가져오기(HTTP fetch)
`websearch`	웹 검색 통합(Web search integration)
`lsp`	편집 전 TypeScript/Python 언어 서버 진단(language server diagnostics)
`todo`	프로젝트 로컬 작업 추적, `.aurict/todos.json`에 영구 저장(persisted)
`apply_patch`	미리보기, GateGuard 검사 및 세밀한 승인을 갖춘 다중 파일 패치 적용(Multi-file patch application)
`subagent`	인라인으로 타입 지정된 전문 에이전트 생성(Spawn a typed specialist agent inline)

Feature	Description
Bash classifier	세 단계 분석(안전/경고/위험)을 거쳐 셸 명령 실행 전 검사
Policy sandbox	낮은 오버헤드의 보호된 실행: 명령어 분류, 승인, 보호 경로, 정제된 환경 변수(env), 시간 초과 설정, 출력 제한 및 감사 로그. 이는 컨테이너 격리가 아니며, Docker는 선택 사항임.
Permission system	도구별 허용/거부 규칙, 와일드카드 경로 일치, 항상 허용 목록
JWT auth	로컬 HTTP API의 Bearer 토큰으로, `~/.aurict/server-token`에서 자동 생성됨.
Mobile release hardening	Android 릴리스 빌드는 CI에서 복원된 서명 비밀(signing secrets)을 사용하며, R8/ProGuard 축소, 리소스 제외, 커밋되지 않은 Firebase 서비스 설정 등을 적용함.
Feedback reporting	모바일 사용자가 개인 백엔드 코드나 비밀을 커밋하지 않고도 어시스턴트 답변에 대한 피드백을 검토용 백엔드 경로로 보고할 수 있음.

Feature	Description
150+ Design systems	Material, Shadcn, Radix, Tailwind, Chakra, Ant Design 등 다수 지원
111 Skill templates	컴포넌트 생성, 레이아웃, 테마 지정(theming), 접근성, 애니메이션 기능 제공
TUI wizard	`/design`을 실행하면 대화형 프로젝트 개요 → 시스템 → 스킬 선택기 순서로 진행됨.
Brief analysis	사용자의 설명을 가장 관련성이 높은 디자인 시스템과 퍼지 매치(Fuzzy-matches)함.

Feature	Description
MCP client	`claude_desktop_config.json` 형식의 MCP 서버 지원 기능
30+ Language LSP	TypeScript, JavaScript, Python, Go, Rust, Ruby, Java, Kotlin, Dart, C/C++ 등 다수 언어 지원
Ollama	Ollama API를 통한 로컬 모델 지원
OpenRouter	단일 API 키로 200개 이상의 모델 접근 가능

릴리스 APK는 수동 모바일 Android 릴리스 워크플로우를 통해 생성됩니다.

모바일 Android 릴리스(Open Mobile Android Release)를 실행합니다.
다음 명령어로 워크플로우를 실행합니다:
apk 또는 both
. - 완료된 실행에서 aurict-android-release-apk 아티팩트를 다운로드합니다.

APK는 CI 과정 중 구성된 Android 릴리스 키스토어와 GitHub Actions 비밀에서 복원된 Firebase google-services.json을 사용하여 서명됩니다. 서명 파일은 리포지토리에 커밋되지 않습니다.

GitHub Releases에서 일치하는 독립형 바이너리를 다운로드하고 SHA-256 체크섬을 검증합니다. Node.js, Bun 또는 sudo가 필요하지 않습니다.

curl -fsSL https://aurict.com/install.sh | bash

변수를 전달하여 특정 릴리스를 설치하거나 다른 디렉토리를 선택할 수 있습니다.

curl -fsSL https://aurict.com/install.sh | AURICT_INSTALL_VERSION=1.2.25 AURICT_INSTALL_DIR=/path/to/bin bash

Bun 런타임을 내장한 단일 독립형 바이너리를 생성하며, 런타임 종속성이 없습니다.

git clone https://github.com/aurict/aurict
cd aurict
bun install
...

npm install -g @aurict/cli
aurict

Bun 1.3 이상 (소스에서 빌드 시)Node.js 20 이상 (npm 패키지용) - 지원되는 제공업체 중 최소 하나에 대한 API 키

# API 키 설정
aurict /config set anthropic sk-ant-...
# TUI 시작 (항상 현재 디렉토리에서 실행됨)
...

aurict [옵션]
-p, --provider <id> 사용할 제공업체 (anthropic, openai, openrouter, google, ollama)
-m, --model <id> 사용할 모델
...

루트 명령어와 버전별 출력 계약은 docs/cli.md에 문서화되어 있습니다.

제공업체	환경 변수	참고 사항
Anthropic	`ANTHROPIC_API_KEY`	Claude 3.5, Claude 4 (Sonnet, Opus, Haiku)
OpenAI	`OPENAI_API_KEY`	GPT-4o, o3, o4-mini
Google	`GOOGLE_GENERATIVE_AI_API_KEY`	Gemini 2.0, 2.5 Flash/Pro
OpenRouter	`OPENROUTER_API_KEY`	단일 엔드포인트로 200개 이상의 모델 지원
Ollama	`OLLAMA_BASE_URL`	로컬 모델, 기본값: `localhost:11434`

전체 참조: docs/slash-commands.md

명령어	설명
`/help`	사용 가능한 모든 명령 목록 표시
`/status`	런타임, 컨텍스트, 권한, 서버 및 작업 상태 표시
`/session`	현재 세션 정보 표시 (ID, 토큰, 메시지 수)
`/sessions`	이전 세션 탐색 및 복원
`/clear`	현재 대화 내용 지우기
`/history`	최근 세션 메시지 및 영구 저장 DB의 끝 부분 표시
`/cost`	세션 토큰 사용량 및 예상 비용 표시
`/exit`	Aurict 종료

명령어 (Command)	설명 (Description)
`/models`	대화형 모델 선택기 열기 (Open interactive model picker)
`/providers`	구성된 제공업체 표시 (Show configured providers)
`/agent`	활성 세션 에이전트 전환 (Omni, Plan, Review 또는 사용자 지정) (Switch active session agent)
`/coordinator`	멀티-에이전트 코디네이터 모드 토글 (Toggle multi-agent coordinator mode)
`/auto`, `/autopilot`	현재 프로젝트의 제한된 파일 변경을 위한 Project Auto 토글 (Toggle Project Auto for bounded file changes in the current project)
`/agents`	`.aurict/agents/` 내 사용자 지정 에이전트 목록 표시 (List custom agents)
`/background`	독립적인 백그라운드 작업 실행, 검사 또는 취소 (Run, inspect, or cancel an independent background task)

명령어 (Command)	설명 (Description)
`/commit`	AI 지원 git 커밋 — 모든 변경 사항을 스테이징하고 메시지 생성 (AI-assisted git commit — stages all changes and generates a message)
`/diffs`	세션의 최근 편집/패치 활동 표시 (Show recent edit/patch activity from the session)
`/worktree`	병렬 개발을 위한 git 워크트리 관리 (Manage git worktrees for parallel development)
`/undo`	마지막 N개 에이전트 단계 되돌리기 (파일 + 대화) (Roll back the last N agent steps)
`/checkpoints`	저장된 체크포인트 목록 표시 (List saved checkpoints)
`/replay`	모든 체크포인트로 이동 (랜덤 액세스) (Jump to any checkpoint)
`/rewind`	N번째 체크포인트까지 대화 되감기 (Rewind conversation to Nth checkpoint)
`/fork`	현재 세션 포크 — 독립적인 사본 생성 (Fork current session — create an independent copy)
`/branch`	대화 포크 또는 브랜치 간 전환 (Fork conversation or switch between branches)

명령어 (Command)	설명 (Description)
`/memory`	세션 전반에 걸쳐 영구 메모리 관리 (Manage persistent memory across sessions)
`/pin`	고정된 컨텍스트 관리 — 시스템 프롬프트에 항상 주입됨 (Manage pinned context — always injected into system prompt)
`/ctx`	컨텍스트 토큰 분해 및 메모리 압력 표시 (Show context token breakdown and memory pressure)
`/compact`	컨텍스트 압축 구성 또는 트리거 (Configure or trigger context compaction)
`/btw`	대화에 영향을 주지 않는 사이드 노트 추가 (Add a side note without affecting the conversation)
`/stash`	초안 입력 저장/복원 (Save/restore draft input)

명령어 (Command)	설명 (Description)
`/init`	기존 내용을 덮어쓰지 않고 Aurict 프로젝트 파일 초기화 (Initialize Aurict project files without overwriting existing)
`/config`	API 키 및 기본값 가져오기 또는 설정 (Get or set API keys and defaults)
`/theme`	색상 테마 변경 (Change the color theme)
`/settings`	설정 패널 열기 (Open settings panel)
`/keys`	모든 키 바인딩 표시 (Show all keybindings)
`/doctor`	설치/제공업체/서버/샌드박스 상태 검사 실행 (Run install/provider/server/sandbox health checks)
`/version`	Aurict 버전 표시 (Show Aurict version)

명령어 (Command)	설명 (Description)
`/skills`	이 프로젝트의 활성 스킬 목록을 표시합니다 (List active skills for this project)
`/skill`	URL 또는 경로를 통해 스킬을 설치/제거합니다 (Install/remove skills by URL or path)
`/plugin`	플러그인 마켓플레이스: 검색, 설치, 제거가 가능합니다 (Plugin marketplace: search, install, remove)
`/skill-scores`	프로젝트별 스킬 효과 점수를 표시합니다 (Show per-project skill effectiveness scores)
`/mcp`	연결된 MCP 서버 목록을 표시합니다 (List connected MCP servers)
`/design`	디자인 에이전트 위자드를 엽니다 (Open the design agent wizard)

명령어 (Command)	설명 (Description)
`/export`	세션을 Markdown 또는 HTML로 내보냅니다 (Export session to Markdown or HTML)
`/share`	세션을 HTML로 내보내고, 선택적으로 transfer.sh에 업로드합니다 (Export session as HTML and optionally upload to transfer.sh)
`/watch`	파일/디렉토리를 감시하며(Watch), 변경 시 프롬프트를 자동 실행합니다 (Watch a file/dir and auto-run a prompt on change)
`/unwatch`	경로 감시를 중지합니다 (Stop watching a path)
`/protect`	GateGuard 보호에 파일 패턴을 추가합니다 (Add a file pattern to GateGuard protection)
`/unprotect`	GateGuard 보호 패턴을 제거합니다 (Remove a GateGuard protection pattern)
`/adr`	`.aurict/decisions/`에서 아키텍처 결정 기록(Architecture Decision Records)을 관리합니다 (Manage architecture decision records in `.aurict/decisions/`)
`/diag`	프로젝트 진단 내용을 확인하고 해결합니다 (View and resolve project diagnostics)
`/crashes`	충돌 보고서(crash reports)를 확인합니다 (View crash reports)
`/editor`	메시지를 작성하기 위해 `$EDITOR`를 엽니다 (Open `$EDITOR` to compose a message)
`/template`	이름이 지정된 메시지 템플릿을 저장하거나 사용합니다 (Save/use named message templates)

단축키 (Shortcut)	동작 (Action)
`Enter`	메시지를 전송합니다 (Send message)
`Shift+Enter`	새 줄을 삽입합니다 (Insert newline)
`Ctrl+←` / `Ctrl+→`	커서를 단어 단위로 이동시킵니다 (Move cursor word by word)
`Ctrl+A`	파일을 첨부합니다 (`@file.ts` 또는 `@file.ts:symbol`) (Attach file (`@file.ts` or `@file.ts:symbol`))
`Ctrl+E`	마지막 사용자 메시지를 수정합니다 (Edit last user message)
`Ctrl+V`	시스템 클립보드에서 붙여넣습니다 (Paste from system clipboard)
`Ctrl+C`	현재 작업을 취소하거나 종료합니다 (Cancel current operation or exit)
`Ctrl+T`	플로팅 작업 패널을 토글합니다 (Toggle floating task panel)
`Ctrl+S`	설정 패널을 엽니다 (Open settings panel)
`Ctrl+X`	서브 에이전트 보기(subagent view)를 토글합니다 (Toggle subagent view)
`Ctrl+O`	접힌 도구 출력을 확장합니다 (Expand collapsed tool output)
`Esc`	오버레이를 닫거나 뒤로 돌아갑니다 (Close overlay / go back)

Aurict는 .aurict/mcp.json에서 MCP 서버 구성을 읽어오며, 이는 claude_desktop_config.json과 동일한 형식을 사용합니다.

{
"mcpServers": {
"filesystem": {
...

MCP 도구는 내장된 도구와 나란히 나타나며 동일한 권한 시스템의 적용을 받습니다.

개발자가 실제로 작업하는 방식에 맞춰진 터미널 네이티브 AI 코딩 어시스턴트

요약

핵심 포인트

댓글

AI 붐에 힘입어 TSMC, 미국 투자 규모를 2650억 달러로 확대: 보고서

Unity 저장 시스템(Save System) 튜토리얼

First Digital, 2억 5천만 달러 규모 KOYN 거래를 통해 나스닥 상장 추진

Canonical, Ubuntu 27.04의 기본 NTP 구현체로 ntpd-rs 사용 계획 재확인

AI 붐에 힘입어 TSMC, 미국 투자 규모를 2650억 달러로 확대: 보고서

Unity 저장 시스템(Save System) 튜토리얼

First Digital, 2억 5천만 달러 규모 KOYN 거래를 통해 나스닥 상장 추진

Canonical, Ubuntu 27.04의 기본 NTP 구현체로 ntpd-rs 사용 계획 재확인