도구 도감

핵심 12 · 그 밖에 설치된 앱 37 · MCP 17 · 스킬 44 = 110종 — 설치된 사용자 앱은 전부, GNOME 설정·시스템 유틸만 제외

표면 CLI 터미널 명령 GUI 창 프로그램(데스크톱 앱 포함) CLI + GUI 같은 제품·두 창구 웹 GUI 브라우저 모델 가중치 파일(단독 실행 아님)

표면	개수	여는 방법	예
CLI	10	터미널 명령 — 스크립트·cron이 부름	bubblewrap · systemd (user) · MuJoCo · Docker
GUI	23	창 프로그램 — 사람이 직접 연다(데스크톱 앱 포함)	Blender · Obsidian · Gazebo · ZED SDK (카메라 도구 8종)
CLI + GUI	8	같은 제품, 두 창구 — 터미널과 창	Orca · Claude Code · ChatGPT · Codex · Antigravity
웹 GUI	5	브라우저 주소로 접속	ComfyUI · AeiROBOT Agent Office · AeiROBOT Data Studio · AeiROBOT SLAM Manager
모델	3	가중치 파일 — 다른 도구가 불러 씀	ControlNet depth (SDXL) · DepthAnything (전처리기) · SDXL base 1.0

설치된 앱 49종을 표면으로 나눈 것 · MCP 17 · 스킬 44 은 표면이 아니라 종류라 따로 센다 · 데스크톱 앱은 GUI로 센다(따로 ‘데스크톱’ 표면은 두지 않는다)

정렬 풀이쉬움전문

ComfyUI SDXL base 1.0 ControlNet depth (SDXL) Orca Claude Code ChatGPT · Codex Antigravity bubblewrap systemd (user) Obsidian DepthAnything (전처리기) Blender

핵심 도구12종 · 매일 쓰는 파이프라인

ComfyUI웹 GUI로컬 이미지 생성기확인(설치·생성·서비스 자동시작)

쉬운 풀이 — 인터넷·요금 없이 내 PC에서 이미지를 만들기 위해.

전문 풀이 — 노드 그래프 기반 확산 파이프라인 실행기. 체크포인트·프롬프트·ControlNet을 DAG로 물려 추론하고, 웹 UI(8188)는 프런트엔드일 뿐 연산은 systemd user 서비스가 상주한다 — /prompt API로 헤드리스 호출도 된다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Comfy Org(오픈소스 커뮤니티), 원작자 comfyanonymous
정의	노드(상자)를 선으로 이어 이미지 생성 순서를 짜는 프로그램
도입	2023년 공개, 지금도 매주 갱신 (설치본 0.43.0)
위치	내 PC(systemd user 서비스) · http://100.75.120.97:8188 (Tailscale, 폰 접속 가능)
고른 이유	유료 API 없이, 원하는 규격을 정확히 맞추기 위해
사용 방식	체크포인트(그림 실력) + 프롬프트(주문) + ControlNet(구도 강제)을 연결

같은 제품의 다른 표면 — 브라우저가 화면, 실제 계산은 systemd 서비스. 헤드리스로 API 호출도 된다

장점

무료·한도 없음
구도를 픽셀 단위로 강제할 수 있음
inpainting으로 부분 수정 가능
모델을 내가 고를 수 있음
폰에서도 접속 가능(Tailscale 주소)

단점

품질이 Gemini/Antigravity보다 낮음
8GB VRAM에서는 큰 모델이 느림
노드 그래프가 처음엔 어려움
모델마다 규격이 달라 삽질이 생김

대체재 ↔ 보완재 · 대신할 것과 곁에 둘 것파란 이름 → 도구 카드 · 청록 이름 → 용어 위키

대체재

같은 자리를 대신한다 · 차이

Antigravity generate_image →추천
구독에 포함(0원), 품질 좋음, 쿼터 있음 — 대량 1차 생성
Gemini API조건부
품질 최상, 장당 과금(2K $0.134 — 2026-11 조사값) — 최종 확정본에만
Codex image_gen →조건부
0원, 주간 한도 공유 — 보조
InvokeAI조건부
캔버스 편집이 강함 — 부분 수정할 때만
Automatic1111 / Forge비추천
UI는 쉽지만 노드 조합이 안 됨 — 확장성 낮음

보완재

곁에 두고 빈틈을 채운다 · 보완점

ControlNet depth →추천
구도를 픽셀 단위로 고정 — 비율·자세가 매번 흔들리는 문제를 잡는다
DepthAnything →추천
참조 이미지의 깊이를 자동 추출해 ControlNet에 바로 먹인다
Blender →추천
정본 치수·각도를 3D로 먼저 고정한 뒤 렌더를 참조로 넣는다
SDXL base 1.0 →추천
그림 실력(체크포인트) 담당 — 모델만 갈아도 그래프는 그대로

보안·권한

모델 파일은 실행 코드가 될 수 있음 → 공식 저장소만
custom node는 임의 코드 실행 → 출처 확인
Tailscale 주소(100.75.120.97)에만 열기 — 공인망·LAN 노출 금지

지난 기록

2026-11-02 도입. 그 전에는 안티그래비티(0원 구독)와 Gemini API(유료)만 있었다. 안티그래비티는 쿼터가 3시간마다 막혔고, API는 장당 $0.134로 90장에 1.6만원이 나갔다. '비율만 고치는 작업'에 돈을 쓰지 않으려고 로컬을 깔았다.

유지 — 비율 교정·대량 변형 담당

외부에서 열기

SDXL base 1.0모델이미지 모델(체크포인트)확인(생성 성공)

쉬운 풀이 — ComfyUI가 그림을 그릴 때 쓰는 '실력' 자체.

전문 풀이 — 1024² 네이티브 확산 체크포인트(가중치 파일). 24스텝 샘플링으로 노이즈를 역방향 제거하며, 프로그램이 아니라 ComfyUI checkpoints 디렉터리에 놓여 로더 노드로만 참조된다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Stability AI
정의	1024×1024 이미지를 만드는 확산 모델
도입	2023년 공개, 지금도 8GB에서 가장 무난
위치	models/checkpoints/ 안
고른 이유	8GB VRAM에서 돌아가는 선에서 품질이 좋음
사용 방식	노이즈에서 시작해 24스텝 동안 그림을 깎아냄

같은 제품의 다른 표면 — 프로그램이 아니라 가중치 파일 — ComfyUI 안에서만 쓴다

장점

8GB에서 1024² 10초
자료(학습법·LoRA)가 가장 많음
fp16 6.9GB로 용량 적당

단점

Flux보다 표현력이 낮음
글자·손가락이 약함
2:1 아이소 각도를 스스로 못 맞춤(실측)

대체재 ↔ 보완재 · 대신할 것과 곁에 둘 것파란 이름 → 도구 카드 · 청록 이름 → 용어 위키

대체재

같은 자리를 대신한다 · 차이

Flux.1 schnell조건부
4~8스텝으로 빠름, 라이선스·VRAM 요구가 다름 — 다음 후보
SD 3.5 medium조건부
텍스트 렌더가 강하지만 LoRA·ControlNet 생태계가 얕음
SD 1.5비추천
가볍고 자료 많지만 해상도·품질이 지금 기준에 못 미침

보완재

곁에 두고 빈틈을 채운다 · 보완점

ControlNet depth →추천
구도만 따로 고정 — 모델을 바꿔도 구도는 유지
LoRA →추천
스타일·캐릭터를 30MB 안팎 파일로 고정
refiner / upscaler추천
낮은 해상도에서 뭉개진 디테일을 2차 패스로 복구
ComfyUI →추천
실행·배선 담당 — 모델 교체만으로 실험

보안·권한

악성 체크포인트(.safetensors 안에 코드는 못 들어감, .ckpt는 위험)
출처 표기·라이선스 확인

지난 기록

ComfyUI와 함께 도입. 처음엔 '각도만 맞추면 되니 싼 모델로 충분하다'고 판단했다.

유지 — 기본 모델

외부에서 열기

ControlNet depth (SDXL)모델구도 강제 장치확인(각도 고정 생성 성공)

쉬운 풀이 — 프롬프트로는 각도가 안 맞아서, 깊이 지도로 구도를 못 박기 위해.

전문 풀이 — depth 조건화 어댑터. 참조 이미지에서 깊이 맵을 뽑아 기하 구조를 잠근 채 생성하므로, 프롬프트만으로 재현하기 어려운 각도·비율을 고정한다. 모델 + 전처리기 노드 쌍으로 동작.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	xinsir(재학습 배포)
정의	입력 이미지의 깊이를 따라 그리게 하는 부품
도입	2023~2024, SDXL용 재학습판
위치	models/controlnet/
고른 이유	2:1 아이소 각도(26.57°)를 매번 똑같이 맞추기 위해
사용 방식	참조 이미지 → depth map → 그 윤곽을 지키며 생성

같은 제품의 다른 표면 — 확장 노드(모델 + 전처리기) — ComfyUI 안에서만 쓴다

장점

각도·배치를 고정할 수 있음
가구 21종을 같은 시점으로 통일
실패율이 크게 줄어듦

단점

참조 이미지가 나빠지면 결과도 나빠짐
depth 추정에도 오차가 있음
모델 2.5GB 추가
depth 템플릿을 상자로 주면 결과도 상자가 됨(강도 0.9 실측)

대체재 ↔ 보완재 · 대신할 것과 곁에 둘 것파란 이름 → 도구 카드 · 청록 이름 → 용어 위키

대체재

같은 자리를 대신한다 · 차이

ControlNet canny조건부
윤곽선 고정. depth보다 물체 경계가 선명 — 라인아트일 때
IP-Adapter조건부
스타일·재질 참조만 담당, 구도는 안 잡음 — 함께 쓰는 쪽
img2img (denoise 0.5) →비추천
구도를 직접 못 정하고 원본에 끌려감 — 구도 고정용으로는 부적합

보완재

곁에 두고 빈틈을 채운다 · 보완점

DepthAnything →추천
손으로 깊이맵을 그리던 일을 자동화
SDXL base 1.0 →추천
구도를 받아 실제 그림을 그리는 쪽
Blender →추천
치수·각도를 3D에서 확정해 깊이맵 원본으로 넘김
ComfyUI →추천
depth·canny 체인을 한 그래프로 묶어 재현 가능하게

보안·권한

참조 이미지에 사람 얼굴이 들어가면 그대로 복제될 수 있음

지난 기록

2026-11-02 도입. 그 전에는 프롬프트에 '2:1 isometric'을 넣었지만 각도가 30~35°로 흔들렸다(실측). 참조 이미지를 넣는 방식도 실패해서(whiteboard 1.21→1.21→1.21) 결국 구도 강제 부품이 필요해졌다.

유지 — 규격 통일의 핵심

외부에서 열기

OrcaCLI + GUI에이전트 작업공간 관리확인(서비스 active)

쉬운 풀이 — 여러 에이전트가 같은 저장소를 동시에 고칠 때 서로 덮어쓰지 않게.

전문 풀이 — git worktree 단위로 후보를 격리하고 각 워크트리에 에이전트 세션을 붙이는 오케스트레이터. 데몬(orca-serve)이 상태를 들고 CLI·IDE가 같은 데몬에 접속한다 — 창이 없어도 동작.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	사내/개인 도구(1.4.244)
정의	워크트리 생성·에이전트 실행·세션 관리
쓰는 때	회의 뒤 구현 라운드마다
위치	백그라운드 데몬(orca-serve.service)
고른 이유	4개 후보를 같은 조건에서 동시에 구현하기 위해
사용 방식	후보마다 독립 폴더(git worktree)와 브랜치를 만들어 격리

같은 제품의 다른 표면 — orca(CLI) · orca-ide(/opt/Orca) · orca-serve.service — 같은 데몬을 본다

장점

후보끼리 파일 충돌 없음
블라인드 비교가 가능
정리(cleanup)가 자동

단점

회의 화면은 아님(오해하기 쉬움)
창을 띄울 필요가 없어 '안 쓰는 것처럼' 보임
worktree 삭제를 손으로 하면 사고

대체재 ↔ 보완재 · 대신할 것과 곁에 둘 것파란 이름 → 도구 카드 · 청록 이름 → 용어 위키

대체재

같은 자리를 대신한다 · 차이

git worktree 직접 →조건부
같은 일을 손으로. 명령 3줄이면 되고 실수 위험은 내 몫 — 간단할 때
Docker 컨테이너 격리 →조건부
더 강한 격리, 이미지 빌드·볼륨 관리가 무겁고 느림 — 보안 강화 시
별도 클론 복사비추천
단순하지만 동기화가 지옥

보완재

곁에 두고 빈틈을 채운다 · 보완점

bwrap →추천
후보 코드가 호스트에서 그대로 실행되는 구멍을 샌드박스로 막음
systemd (user) →추천
orca-serve 데몬이 죽어도 다시 살림
compare-agent-diffs 스킬 →추천
후보 결과를 블라인드 A/B로 비교하는 절차를 고정
git추천
워크트리·브랜치·머지의 바닥 — 되돌릴 수 있게

보안·권한

워크트리에 비밀키가 복사되지 않게 주의
후보 코드가 호스트에서 실행됨 → bwrap 샌드박스 병행

지난 기록

회의(토론)에는 필요 없다. 구현 라운드에서만 쓴다. 처음엔 plain git worktree로 시작했고, 에이전트가 index.lock을 잡고 늘어져서 Orca로 옮겼다.

유지 — 구현·비교 전용

외부에서 열기

Claude CodeCLI + GUI구현 에이전트확인

쉬운 풀이 — 계획을 코드로 바꾸는 구현자 중 한 명.

전문 풀이 — 터미널 상주 코딩 에이전트(2.1.311). 저장소를 읽고 도구 호출로 파일을 수정하며, 데스크톱 앱(claude-desktop 3.6556.2)은 같은 세션을 폴더 단위로 실행하는 GUI 표면이다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Anthropic
정의	터미널에서 도는 코딩 에이전트(2.1.311)
쓰는 때	라운드마다
위치	워크트리 안
고른 이유	문맥 이해가 좋아 큰 수정에 강함
사용 방식	프롬프트 + 저장소를 읽고 파일을 고침

같은 제품의 다른 표면 — Claude 앱(claude-desktop 3.6556.2)도 로컬 폴더를 골라 세션을 돌린다 — "Choose a folder to work in", Claude Code CLI 세션 가져오기 지원. 터미널 없이 쓰려면 앱, 스크립트 자동화는 CLI.

장점

긴 문맥 이해
설명이 친절
테스트 작성에 강함

단점

샌드박스에서 git/bash 거부가 잦음(실측)
느림
5시간 한도(92% critical 관측)

대체재 ↔ 보완재 · 대신할 것과 곁에 둘 것파란 이름 → 도구 카드 · 청록 이름 → 용어 위키

대체재

같은 자리를 대신한다 · 차이

Codex CLI →추천
다른 계열 모델. 같은 계획을 다르게 구현해 비교 기준이 됨 — 기본 구현자
Kimi →조건부
긴 문맥·저렴 — 대량 반복에 보조
Antigravity →조건부
데스크톱 앱에서 채팅으로 지시 — 자동화는 agy -p

보완재

곁에 두고 빈틈을 채운다 · 보완점

Orca →추천
후보별 격리 워크트리와 세션 관리
bwrap →추천
에이전트가 실행하는 명령의 범위를 제한
Codex CLI →추천
같은 작업을 교차 검토해 계열 독립성 확보
MCP 서버 →조건부
파일·브라우저·DB 같은 외부 도구를 연결

보안·권한

회사/개인 계정 분리 필요(작성자 섞이면 push 거부)
대화 내용이 외부로 감

지난 기록

r1~r3에서 계속 후보로 참여, r3에서 비밀 채점 PASS. 다만 최종 채택은 codex가 3회. 2026-11-03 정정 — 앱을 "대화용"으로만 적었는데, 실제로는 로컬 폴더 세션과 Claude Code CLI 세션 가져오기를 지원한다(claude-desktop 3.6556.2). 표면을 CLI → CLI + GUI로 고침.

유지 — 구현 후보

외부에서 열기

ChatGPT · CodexCLI + GUI대화 앱 + 구현 에이전트확인

쉬운 풀이 — 가장 안정적으로 시험을 통과하는 구현자 — 터미널(CLI)과 대화 창(앱)이 같은 계정으로 이어진다.

전문 풀이 — Codex CLI(0.164.0)와 ChatGPT 앱 번들(0.159.0)이 같은 계정·같은 모델에 붙는 이중 표면. CLI는 codex exec -s workspace-write로 비대화 실행, 앱은 codex:// 핸들러로 세션을 열고 폴더 신뢰 후 샌드박스 쓰기를 허용한다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	OpenAI
정의	터미널 코딩 에이전트(CLI 0.164.0) + 대화형 데스크톱 앱(Electron, 1.6GB, 앱 안 Codex 0.159.0 번들)
쓰는 때	구현 라운드마다(CLI) · 조사·번역·초안(앱)
위치	워크트리 안(CLI) · /usr/lib/chatgpt, 실행 /usr/bin/chatgpt(앱)
고른 이유	r1·r2·r3 전부 채택 — 코드는 CLI, 물어보는 일은 앱
사용 방식	codex exec로 비대화 실행(-s workspace-write), 앱에서는 대화로. codex:// 링크는 앱이 받는다

같은 제품의 다른 표면 — GUI 표면은 ChatGPT 앱(deb chatgpt 26.928.20755, 1.6GB)에 번들된 Codex 0.159.0 — CLI는 0.164.0이라 버전이 갈린다. 앱이 codex:// 링크를 받고, 폴더를 신뢰 처리하면 그 폴더를 읽고 편집·실행한다.

장점

채택 3회(실측)
속도·안정 균형
비밀 채점 통과
앱은 로그인만 하면 바로 쓴다(csv·docx·pptx·xlsx 열기 등록됨)
앱 안 Codex 탭에서 폴더를 신뢰하면 그 폴더를 읽고 편집·실행

단점

워크트리 index.lock 문제(호스트 autocommit으로 우회)
주간 한도 97%까지 소진 관측
앱 번들 0.159.0 < CLI 0.164.0 — 버전이 갈린다
앱만 1.6GB
앱 대화는 클라우드로 간다(로컬 처리 없음)

대체재 ↔ 보완재 · 대신할 것과 곁에 둘 것파란 이름 → 도구 카드 · 청록 이름 → 용어 위키

대체재

같은 자리를 대신한다 · 차이

Claude Code →추천
다른 계열. 심사자·구현자를 갈라 배정할 때 쓴다 — 후보
Claude 앱 →추천
대화가 중심인 GUI — 코드는 CLI 쪽이 낫다
Kimi →조건부
값싼 반복 작업용 — 후보

보완재

곁에 두고 빈틈을 채운다 · 보완점

Orca →추천
워크트리 격리 + 실행 기록
Claude Code →추천
교차 검토로 같은 실수를 두 번 막음
bwrap →추천
실행 명령의 범위 제한
image_gen →조건부
코드가 아니라 그림이 필요할 때

보안·권한

구독 한도를 이미지 생성에 쓰지 않는다(384 크레딧은 리셋권)
codex-home에 자격증명 보관
사내 코드·키·고객 정보를 앱 대화에 붙여넣지 않는다

지난 기록

처음엔 claude를 기본으로 생각했지만, r1부터 codex가 시험을 덜 깨뜨렸다. 3라운드 연속 채택은 우연이 아니라 재현된 결과다. 2026-11-03 확인 — 데스크톱 몫은 ChatGPT 앱 번들 0.159.0이고 CLI는 0.164.0으로 버전이 다르다. 2026-11-03 정정 — ChatGPT 앱과 Codex는 같은 제품(앱 + CLI)이라 카드 하나로 합쳤다.

유지 — 기본 구현자

외부에서 열기

AntigravityCLI + GUI데스크톱 에이전트 + 이미지 생성확인

쉬운 풀이 — 구독에 이미지 생성이 포함되어 있어 0원으로 대량 생성이 가능.

전문 풀이 — Gemini 구독 쿼터를 쓰는 에이전트 앱 + CLI(1.4.12). generate_image 도구를 --mode accept-edits로 비대화 호출하며, 앱과 CLI의 대화 저장소가 분리된다(~/.gemini/antigravity vs -cli).

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Google
정의	에이전트 데스크톱 앱 + CLI 1.4.12 + generate_image 도구
쓰는 때	이미지 1차 생성
위치	앱 ~/.gemini/antigravity · CLI ~/.gemini/antigravity-cli/brain/<대화>/
고른 이유	Gemini API는 장당 $0.134, 이쪽은 구독 포함
사용 방식	agy -p "Use the generate_image tool ..." --mode accept-edits

같은 제품의 다른 표면 — IDE는 별도 앱 "Antigravity IDE"로 분리됐다 — 이 PC에는 없다(앱 안에서 내려받는 안내가 뜬다). 앱과 CLI는 저장 폴더가 다르다: 앱 ~/.gemini/antigravity, CLI ~/.gemini/antigravity-cli. Gemini API와는 다른 경로다 — 구독(Google 계정, cloudcode-pa.googleapis.com)으로 부르고, 모델 메뉴에 Gemini 4 Argon·3.8 Flash뿐 아니라 Claude Opus 5.5·GPT-OSS 120B도 있다.

장점

0원
품질 좋음
1024² 즉시

단점

쿼터 소진(3시간 42분 대기 관측)
allow 목록 밖 경로에서 0바이트·rc=0 조용한 실패(실측)
결과 파일 추적이 까다로움
앱과 CLI의 대화 저장소가 따로 쌓인다

대체재 ↔ 보완재 · 대신할 것과 곁에 둘 것파란 이름 → 도구 카드 · 청록 이름 → 용어 위키

대체재

같은 자리를 대신한다 · 차이

ComfyUI →추천
무료·무제한, 비율 교정 반복에 강함. 품질은 낮음 — 교정용
Gemini API조건부
API 키로 직접 호출, 장당 과금 — 같은 Gemini 모델을 다른 창구로 부르는 셈
Codex image_gen →조건부
0원, 주간 한도 공유 — 보조

보완재

곁에 두고 빈틈을 채운다 · 보완점

Blender →추천
치수·각도 정본을 먼저 잡아 프롬프트 흔들림을 줄임
ComfyUI →추천
쿼터가 막힌 뒤의 반복 수정을 넘겨받음
DepthAnything →추천
참조 구도를 깊이맵으로 바꿔 다른 도구에 넘김

보안·권한

헤드리스 실행 시 파일 저장 경로 검증 필수 — 조용한 실패 주의

지난 기록

처음엔 'Gemini API만 있으면 된다'고 했는데, 실제로는 안티그래비티 구독에 generate_image가 들어 있었다. 2026-11-03 확인해 정정했다(21회 호출 흔적 발견). 2026-11-03 정정 — 설치된 앱은 코드 에디터가 아니라 에이전트 채팅 데스크톱 앱이다(파일 트리·에디터 없음, Electron 492MB). 앱 자체 안내도 "코드 에디터가 필요하면 Antigravity IDE를 별도 앱으로 받으라"고 말한다. IDE는 이 PC에 없고, 앱과 CLI의 저장 폴더도 서로 다르다.

유지 — 1차 생성 1순위

외부에서 열기

bubblewrapCLI샌드박스확인

쉬운 풀이 — 에이전트가 실행하는 코드를 내 PC 전체에서 격리하기 위해.

전문 풀이 — 사용자 네임스페이스 기반 샌드박스(0.9.0). 홈을 ro-bind, 작업 폴더만 rw로 걸어 에이전트가 실행하는 코드의 쓰기 범위를 파일시스템 수준에서 제한한다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	GNOME/Flatpak 재단
정의	권한 없는 사용자 네임스페이스 샌드박스(0.9.0)
쓰는 때	구현 라운드 실행 시
위치	sandbox.py 안
고른 이유	후보 코드가 홈을 건드리지 못하게
사용 방식	bwrap로 홈을 읽기전용, 작업 폴더만 쓰기 허용

장점

설치가 간단
root 불필요
컨테이너보다 가벼움

단점

네트워크 차단은 별도 설정
커널 설정에 따라 안 될 수 있음

대체재 ↔ 보완재 · 대신할 것과 곁에 둘 것파란 이름 → 도구 카드 · 청록 이름 → 용어 위키

대체재

같은 자리를 대신한다 · 차이

Docker →조건부
이미지·네트워크 관리까지. 무겁고 시작이 느림 — 대안
firejail조건부
프로필이 쉽지만 세밀한 바인드 제어가 약함 — 대안
격리 없이 그냥 실행비추천
편하지만 후보 코드가 홈을 그대로 만짐 — 격리 없이 실행

보완재

곁에 두고 빈틈을 채운다 · 보완점

Orca →추천
후보별 실행에 같은 샌드박스 규칙을 적용
git추천
실수해도 되돌릴 수 있는 바닥 — 격리 + 버전
systemd (user) →조건부
샌드박스 실행을 서비스 단위로 관리

보안·권한

기본은 홈 읽기전용 + 작업폴더만 쓰기
비밀키 경로는 마운트 제외

지난 기록

파이프라인 수정 5종 중 하나로 도입. 그 전에는 에이전트가 호스트에서 그대로 돌았다.

유지 — 실행 격리

외부에서 열기

systemd (user)CLI데몬·예약 실행확인(active)

쉬운 풀이 — 내가 꺼져 있어도 서비스가 계속 돌게 하려고.

전문 풀이 — 사용자 인스턴스(systemctl --user)의 서비스 관리자. linger를 켜면 로그인 세션과 무관하게 상주하고, 유닛 파일은 ~/.config/systemd/user에 둔다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	systemd 프로젝트
정의	사용자 서비스 관리자
쓰는 때	부팅 때부터
위치	~/.config/systemd/user/
고른 이유	orca-serve가 항상 떠 있어야 함
사용 방식	systemctl --user enable --now + linger

같은 제품의 다른 표면 — systemctl --user 로만 다룬다 — GUI 없음

장점

재부팅에도 자동 시작
로그 조회 쉬움
cron보다 관리 편함

단점

linger 설정을 빼먹으면 로그인 전엔 안 돎
유저 서비스는 권한이 제한적

대체재 ↔ 보완재 · 대신할 것과 곁에 둘 것파란 이름 → 도구 카드 · 청록 이름 → 용어 위키

대체재

같은 자리를 대신한다 · 차이

cron →조건부
분 단위 단발 예약. 로그·의존성 관리가 없음
supervisord비추천
파이썬 프로세스 관리. 지금 구성에선 겹치는 층
tmux →비추천
세션이 죽으면 끝. 재시작 보장 없음

보완재

곁에 두고 빈틈을 채운다 · 보완점

bwrap →추천
서비스가 실행하는 명령을 격리
journalctl →추천
실패 원인을 시각·우선순위로 추적
daily.py추천
예약 실행되는 실제 작업(09:00 보고서)

보안·권한

유저 서비스는 root 권한 없음(안전)
환경변수에 비밀키를 넣지 않는다

지난 기록

orca-serve를 수동으로 띄우다가 재부팅마다 꺼져서 systemd로 옮겼다.

유지

외부에서 열기

ObsidianGUI지식 저장소확인

쉬운 풀이 — 결정·근거·실패를 한 곳에 남겨 다음에 같은 실수를 안 하려고.

전문 풀이 — 마크다운 파일을 직접 읽는 노트 클라이언트 — DB 없이 볼트 디렉터리가 곧 저장소다. 노트 규격(두괄식 + summary callout)은 파일 포맷 규약으로 강제된다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Obsidian
정의	마크다운 노트 앱(볼트는 ~/dev/obsidian)
쓰는 때	회의·결정·실패 직후
위치	주제별 지식/주제/<분야>/
고른 이유	대화는 사라지지만 노트는 남는다
사용 방식	관리/노트 형식.md 규격(두괄식 + summary callout)

장점

로컬 파일이라 종속 없음
검색·링크 강함
git으로 백업 가능

단점

모바일 동기화는 별도 설정
규격을 안 지키면 금방 엉망

대체재 ↔ 보완재 · 대신할 것과 곁에 둘 것파란 이름 → 도구 카드 · 청록 이름 → 용어 위키

대체재

같은 자리를 대신한다 · 차이

Notion조건부
협업·DB 강함, 로컬 파일이 아님 — 대안
Logseq조건부
아웃라이너·저널 중심 — 대안
그냥 메모장비추천
검색·링크·백링크 없음

보완재

곁에 두고 빈틈을 채운다 · 보완점

ripgrep추천
볼트 전체를 즉시 검색
git추천
노트 변경 이력·복구
daily.py추천
todo.md·goals.md를 보고서 소스로 읽음

보안·권한

볼트에 비밀키를 넣지 않는다
git 원격은 개인 저장소로

지난 기록

채팅 기록만으로는 3주 전 결정의 이유를 못 찾았다. 그래서 '왜'를 남기는 곳으로 정했다.

유지

외부에서 열기

DepthAnything (전처리기)모델깊이 자동 추출확인(desk·sofa 추출 성공)

쉬운 풀이 — 그림에서 깊이 지도를 뽑아 ControlNet에 넣기 위해. 손으로 depth를 그리지 않으려고.

전문 풀이 — 단안 깊이 추정 전처리기. LoadImage → DepthAnythingPreprocessor → ControlNet 순으로 물려 회색 깊이 맵을 만들고, 수동 depth 페인팅을 대체한다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	LiheYoung(원본) / Fannovel16(ComfyUI 래퍼)
정의	이미지 한 장 → 회색 깊이 지도
도입	2024년, 지금도 표준
위치	custom_nodes/comfyui_controlnet_aux
고른 이유	참조 이미지의 구도를 그대로 살리려고
사용 방식	LoadImage → DepthAnythingPreprocessor → ControlNet

같은 제품의 다른 표면 — 전처리기 노드 — ComfyUI 안에서만 쓴다

장점

참조 그림의 구도를 정확히 뽑음
모델 3종 선택(vits/vitb/vitl)
해상도 2048까지

단점

첫 실행 때 모델 자동 다운로드(느림)
투명 배경·얇은 물체는 깊이가 뭉개짐
vitl14는 1.3GB

대체재 ↔ 보완재 · 대신할 것과 곁에 둘 것파란 이름 → 도구 카드 · 청록 이름 → 용어 위키

대체재

같은 자리를 대신한다 · 차이

Zoe Depth조건부
실내 스케일 추정이 안정적, 설치가 무거움 — 대안
MiDaS비추천
깊이 경계가 뭉개져 가구 윤곽이 흐림
수동 depth 그리기비추천
시간이 몇 배, 재현 불가

보완재

곁에 두고 빈틈을 채운다 · 보완점

ControlNet depth →추천
추출한 깊이맵을 구도 고정에 바로 사용
ComfyUI →추천
전처리→생성을 한 그래프에서 처리
Blender →추천
3D에서 깊이맵을 직접 렌더해 정답지로 씀

보안·권한

모델 자동 다운로드는 출처 확인 필요
업로드 이미지가 output 폴더에 남음

지난 기록

2026-11-02 도입. 그 전에는 회색조를 depth 대용으로 넣어 '설치 확인'만 했다. 진짜 depth가 필요해 추가했다.

유지 — 참조 구도 추출

외부에서 열기

BlenderGUI3D 모델링·렌더확인(가구 21종 + 로봇 2종 URDF 렌더)

쉬운 풀이 — 가구를 실제 치수로 3D로 만들어 2:1 아이소 각도·비율을 정확히 고정하기 위해.

전문 풀이 — 포터블 3D DCC(4.2.15). build.py로 가구 형상을 절차적으로 조립하고 지정 카메라에서 깊이 패스까지 렌더해 ControlNet 입력으로 넘긴다 — blender -b 배치도 가능하나 이 파이프라인은 GUI 조립.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Blender Foundation(네덜란드 재단)
정의	3D 모델·렌더·애니메이션 무료 프로그램
도입	2002년 시작, 지금 4.2 LTS
위치	~/apps/blender-4.2.15-linux-x64 (포터블, 관리자 권한 불필요)
고른 이유	AI 그림은 치수를 못 지킨다. 3D는 치수가 곧 데이터다.
사용 방식	build.py로 가구 조립 → 깊이 렌더 → ControlNet에 투입

같은 제품의 다른 표면 — blender -b 로 배치 실행도 되지만 이 파이프라인은 GUI로 조립한다

장점

치수·각도가 100% 정확
0원·무제한·오프라인
깊이·색·그림자·8방향을 같은 각도로 뽑음
파이썬(bpy)으로 자동화
URDF+STL을 그대로 불러와 실제 형상 유지(robot.py)

단점

가구마다 모델링 코드를 써야 함
초보에게 UI가 어려움
사진 같은 질감은 약함(AI가 보완)

대체재 ↔ 보완재 · 대신할 것과 곁에 둘 것파란 이름 → 도구 카드 · 청록 이름 → 용어 위키

대체재

같은 자리를 대신한다 · 차이

Antigravity 2K 이미지(구독) →조건부
질감·디테일은 강하지만 치수가 틀어짐 — 질감 전용 병행
Sweet Home 3D조건부
평면 배치엔 빠르지만 정밀 렌더·URDF 없음 — 대안
SketchUp비추천
간단하지만 스크립트·렌더 파이프라인이 약함

보완재

곁에 두고 빈틈을 채운다 · 보완점

ComfyUI →추천
3D 렌더를 참조로 이미지 생성 — 치수는 Blender, 질감은 생성 모델
DepthAnything →추천
렌더에서 깊이맵을 뽑아 구도 고정에 사용
ControlNet depth →추천
렌더 구도를 생성 모델에 강제한다
Python(bpy) 스크립트추천
치수·각도를 코드로 고정해 손작업 없이 재현

보안·권한

포터블 압축본(350MB) — 공식 배포처에서 받아야 함
외부 통신 없음(완전 오프라인)

지난 기록

2026-11-02 도입. 그 전에는 Gemini·안티그래비티로 2K 마스터를 뽑았는데, 책상이 0.73타일·소파 0.88·화이트보드 1.71로 비율이 전부 어긋났다. 참조 이미지로는 안 고쳐졌고, 정본 치수 depth를 직접 그려도 '상자'만 나왔다(강도 0.9). 3D로 만들면 그 문제 자체가 사라진다. 2026-11-02 심야: URDF 임포터 작성 → Alice5(1.72m)·M2(1.82m) 조립·8방향 렌더.

채택 — 정본 치수·각도 고정 담당

외부에서 열기

그 밖에 설치된 앱37종 · 가끔 쓰는 것까지

ZED SDK (카메라 도구 8종)GUI스테레오 카메라 · 깊이확인

쉬운 풀이 — AI가 추정한 깊이가 아니라 실제 센서가 잰 깊이가 필요할 때

전문 풀이 — 스테레오 카메라 SDK 5.4.1과 8개 도구. 센서 깊이를 직접 취득하므로 추정 모델과 달리 스케일이 실측이고, Studio에서 녹화한 SVO를 재생해 같은 장면을 반복 검증한다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Stereolabs
정의	ZED SDK 5.4.1 + ZED Studio·Depth Viewer·ZEDfu·Calibration·Explorer·Sensor Viewer·Sensor Placer·Diagnostic
쓰는 때	카메라 다룰 때
위치	/usr/local/zed (181MB) · 툴은 데스크톱 항목에서 실행
고른 이유	AI가 추정한 깊이가 아니라 실제 센서가 잰 깊이가 필요할 때
사용 방식	ZED Studio에서 녹화·재생, Depth Viewer로 실시간 깊이 확인

실측 깊이 — DepthAnything 추정의 정답지가 된다
로컬 처리(영상이 밖으로 나가지 않음)

카메라가 연결돼 있어야 의미가 있다
CUDA 의존이라 GPU 드라이버에 민감

보안·권한

영상은 로컬 파일로만 저장 — 외부 전송 없음(툴 단위 확인)

확인 — 실측 깊이용

외부에서 열기

Unity (Hub + Editor)GUI씬·프리팹 · 3D 제작확인

쉬운 풀이 — Blender가 정적 모델이라면, Unity는 배치·카메라·조명을 굴려보는 곳

전문 풀이 — Hub가 관리하는 두 Editor(6000.3.2f1·6000.6.5f1). Blender가 정적 메시라면 씬·프리팹·조명·카메라를 런타임에 배치해 각도를 검증하는 쪽이다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Unity Technologies
정의	Unity Hub 3.22.2 + Editor 6000.3.2f1 · 6000.6.5f1 두 버전
쓰는 때	씬·배치 실험
위치	~/Unity/Hub (40GB — 이 기계에서 가장 큰 설치)
고른 이유	Blender가 정적 모델이라면, Unity는 배치·카메라·조명을 굴려보는 곳
사용 방식	Hub에서 프로젝트를 열고 씬에서 카메라 각도를 잡는다

버전 2개 공존 — 프로젝트별로 골라 열 수 있음
실시간 프리뷰로 구도 확인

40GB 차지
무거워서 한 번 켜면 오래 잡아먹는다

보안·권한

프로젝트 폴더가 곧 데이터 — git에 통째로 넣으면 터진다(.gitignore 필수)

확인 — Blender와 역할 분리

외부에서 열기

AionUiGUICLI 에이전트 GUI확인

쉬운 풀이 — 터미널 창을 여러 개 띄우지 않고 에이전트를 나란히 보고 싶을 때

전문 풀이 — 여러 CLI 에이전트를 탭이 아니라 화면 분할로 동시에 관찰하는 Electron 셸(981MB). 기동 시 CDP 브리지를 열어 브라우저 자동화를 노출한다(실측 로그).

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	제작자 표기 없음(오픈소스 데스크톱 클라이언트로 보임) — 확인 필요
정의	여러 CLI 에이전트를 한 화면에서 다루는 데스크톱 앱(Electron, 981MB)
쓰는 때	확인 필요
위치	/opt/AionUi · 설정 ~/.config/AionUi
고른 이유	터미널 창을 여러 개 띄우지 않고 에이전트를 나란히 보고 싶을 때
사용 방식	/opt/AionUi/AionUi 로 실행 — 실행하면 '[CDP] Agent browser control enabled' 를 찍는다(실측)

설치돼 있음(981MB)
설정이 ~/.config/AionUi 에 남는다

실제 작업에 써보지 않아 판단 보류
에이전트 설정을 앱이 따로 들고 있으면 CLI와 어긋날 수 있음

보안·권한

에이전트가 브라우저를 조작할 수 있는 브리지를 켠다(CDP) — 격리 확인 필요

확인 필요

외부에서 열기

Kimi CodeCLI + GUICLI 2.4.1 + GUI 앱확인

쉬운 풀이 — 긴 문맥 모델로 코드를 볼 때 후보

전문 풀이 — Kimi Code CLI(2.4.1)와 데스크톱 앱이 같은 제품의 두 표면. kimi -p로 원샷 실행, import-sessions로 Claude·Codex 세션을 흡수하며, CLI가 세션·스킬 API를 더 많이 노출한다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Moonshot AI (Kimi) — CLI는 자체 업데이터로 설치
정의	Kimi Code CLI 2.4.1 (~/.kimi-code) + Kimi Code 데스크톱(Electron, 370MB)
도입	2026-10 CLI 설치 · 2026-11 데스크톱 앱
위치	CLI: ~/.kimi-code/bin/kimi · 앱: /opt/Kimi Code
고른 이유	긴 문맥 모델로 코드를 볼 때 후보
사용 방식	kimi (대화) · kimi -p "질문" (한 번에) · kimi import-sessions (Claude·Codex 세션 가져오기)

세션·스킬·에이전트 프로필·ACP 서버까지 CLI가 다룬다
kimi web 으로 로컬 웹 UI도 뜬다
Claude Code·Codex 세션을 import-sessions 로 가져올 수 있다

기본 모델이 aei-robot 전용(aeirobot/Arobot)으로 잡혀 있다 — 범용으로 쓰려면 모델 교체
실사용 기록 아직 없음

보안·권한

코드를 클라우드로 보낸다 — 사내 코드 정책 확인

확인 — 후보

외부에서 열기

Visual Studio CodeGUI코드 편집확인

쉬운 풀이 — 에이전트가 고친 코드를 눈으로 확인할 때

전문 풀이 — Electron 코드 편집기(1.139.1). code <경로>로 열고, 에이전트가 만든 diff를 언어 서버와 git 확장으로 검증하는 용도로 쓴다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Microsoft
정의	코드 편집기 1.139.1 (971MB)
쓰는 때	가끔 직접 볼 때
위치	/usr/share/code · 설정 ~/.config/Code
고른 이유	에이전트가 고친 코드를 눈으로 확인할 때
사용 방식	code <경로> 로 열기

확장 생태계가 가장 넓다
diff 보기가 익숙하다

무겁다(971MB)
에이전트가 만든 변경을 읽기만 하면 되는데 IDE 전체를 띄우는 건 과하다

보안·권한

확장이 파일을 읽는다 — 신뢰 못 할 확장은 설치하지 않는다

확인 — 읽기 전용으로

외부에서 열기

HermesCLI + GUINous Research 에이전트확인

쉬운 풀이 — 에이전트를 하나 더 굴려 비교할 때

전문 풀이 — Nous Research 에이전트 런타임(v0.22.2). hermes desktop --skip-build로 Electron 창을 띄우며, 구현자 비교 실험의 추가 후보로 굴린다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Nous Research
정의	Hermes Agent v0.22.2 — `hermes desktop` 으로 창도 뜬다
쓰는 때	확인 필요
위치	~/.local/bin/hermes · 데스크톱 항목 com.nousresearch.hermes
고른 이유	에이전트를 하나 더 굴려 비교할 때
사용 방식	hermes desktop --skip-build

CLI와 GUI 두 표면
자체 모델 계열(Nous)과 묶여 있다

이 파이프라인에서는 아직 안 씀
계정·키 설정이 따로 필요

보안·권한

에이전트가 로컬 파일을 만질 수 있다 — 격리는 bwrap 몫

확인 필요

외부에서 열기

GitHub DesktopGUIgit GUI확인

쉬운 풀이 — 터미널 없이 diff·커밋을 눈으로 볼 때

전문 풀이 — git CLI의 GUI 프런트엔드(3.4.12). index·diff·커밋을 시각화하지만 내부적으로는 git 명령을 그대로 호출한다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	GitHub(Microsoft)
정의	git 클라이언트 3.4.12
쓰는 때	커밋 정리할 때
위치	시스템 패키지(github-desktop)
고른 이유	터미널 없이 diff·커밋을 눈으로 볼 때
사용 방식	저장소 폴더를 열어 변경을 훑는다

diff가 한눈에 보인다
실수로 스테이징한 파일을 되돌리기 쉽다

worktree 여러 개를 다루기엔 터미널이 빠르다
index.lock 사고를 막아주진 않는다

보안·권한

로그인하면 저장소 목록이 GitHub로 간다

확인 — 가끔

외부에서 열기

AeiROBOT Agent Office웹 GUI에이전트 3층 사무실 대시보드확인

쉬운 풀이 — 에이전트가 지금 뭘 하는지 눈으로 보려고

전문 풀이 — Claude·Codex·Hermes 세션 로그를 3층 사무실 메타포로 시각화하는 대시보드. start.sh가 서버를 띄우고 브라우저가 붙으며, 커밋 기록이 여기서 나온다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	AeiROBOT(자체)
정의	Claude·Codex·Hermes 작업을 3층 사무실로 보여 주는 대시보드 — 매일 커밋이 여기서 나온다
쓰는 때	항상
위치	~/dev/agent-office (start.sh --open)
고른 이유	에이전트가 지금 뭘 하는지 눈으로 보려고
사용 방식	./start.sh 로 띄우고 브라우저로 본다

커밋 로그의 출처가 이 화면
여러 에이전트 상태를 한 장에

직접 만든 도구라 버그도 직접 진다
동작이 바뀌면 문서가 금방 낡는다

보안·권한

에이전트 상태·로그를 로컬에만 둔다

유지 — 매일 봄

AeiROBOT Agent ManagerGUI에이전트 설치·관리확인

쉬운 풀이 — 새 에이전트를 붙일 때 손으로 설정 파일을 안 고치려고

전문 풀이 — 에이전트 설치·설정을 GUI로 감싼 관리 도구. 설정 파일을 손으로 고치지 않고 에이전트별 프로비저닝을 대신 수행한다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	AeiROBOT(자체)
정의	AeiROBOT 코딩 에이전트를 설치·관리하는 설정 GUI
쓰는 때	에이전트 추가할 때
위치	패키지 실행파일 aeirobot-ai-agent-setup-gui
고른 이유	새 에이전트를 붙일 때 손으로 설정 파일을 안 고치려고
사용 방식	GUI에서 에이전트를 골라 설치·설정

설정을 손으로 안 고쳐도 된다
설치 경로를 한 곳에서 관리

확인 필요 — 실제 사용 기록 없음

보안·권한

에이전트 설정 파일을 쓴다 — 백업 없이 저장하면 되돌리기 어렵다

확인 필요

AeiROBOT Data Studio웹 GUI데이터 수집·전처리확인

쉬운 풀이 — 로봇 데이터를 모으고 손보는 창구

전문 풀이 — 로봇 데이터 수집·전처리·텔레오퍼레이션 웹 UI(8000). 세션 단위로 녹화하고 전처리 파이프라인을 건다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	AeiROBOT(자체)
정의	데이터 수집·전처리·텔레오퍼레이션 웹 UI (포트 8000)
쓰는 때	데이터 만들 때
위치	aeirobot-web data · http://localhost:8000
고른 이유	로봇 데이터를 모으고 손보는 창구
사용 방식	웹 UI에서 세션을 만들고 녹화·전처리

브라우저만 있으면 원격에서도
수집과 전처리가 한 화면

포트 8000을 점유 — 다른 서버와 부딪힐 수 있다
확인 필요 — 이번 주 사용 기록 없음

보안·권한

로봇 데이터가 로컬에 쌓인다 — 백업·용량 관리 필요

확인 필요

AeiROBOT SLAM Manager웹 GUI주행·시뮬 제어확인

쉬운 풀이 — SLAM·주행 스택을 켜고 끄고 상태를 볼 때

전문 풀이 — 주행·시뮬레이션 스택 제어 웹 UI(8090). --sim으로 시뮬레이터에 붙어 스택 기동과 상태를 관리한다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	AeiROBOT(자체)
정의	주행·시뮬레이션 스택 제어 웹 UI (포트 8090, --sim)
쓰는 때	주행 실험할 때
위치	aeirobot-web driving --sim · http://localhost:8090
고른 이유	SLAM·주행 스택을 켜고 끄고 상태를 볼 때
사용 방식	웹 UI에서 시뮬 모드로 실행

시뮬로 먼저 돌려볼 수 있다
상태를 한 화면에서

확인 필요 — 이번 주 사용 기록 없음
실기와 시뮬 설정이 갈리면 결과가 다르다

보안·권한

로봇 제어 권한을 가진 UI — 열어둔 채 두지 않는다

확인 필요

Qt Creator (+ Qt 5 도구)GUIC++ IDE확인

쉬운 풀이 — ROS·C++ 노드를 직접 고칠 때

전문 풀이 — Qt Creator 13.0.0 + Qt5 도구 모음. ROS·C++ 노드를 CMake 프로젝트로 열어 직접 수정할 때 쓰는 IDE.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Qt Group
정의	Qt Creator 13.0.0 + Qt5 Designer·Assistant·Linguist
쓰는 때	C++ 만질 때
위치	시스템 패키지(qtcreator)
고른 이유	ROS·C++ 노드를 직접 고칠 때
사용 방식	qtcreator 로 프로젝트 열기

C++ 디버깅이 편하다
Qt UI 설계 도구가 같이 온다

ROS 빌드는 결국 colcon — IDE는 편의
무겁다

보안·권한

빌드 스크립트 실행 권한 — 신뢰한 프로젝트만

확인 — 가끔

외부에서 열기

NVIDIA 개발 도구 (Nsight·SDKManager)GUIGPU 프로파일링확인

쉬운 풀이 — 이미지 생성이 왜 느린지 재려면 프로파일러가 필요

전문 풀이 — CUDA 13.0 툴체인 + Nsight 계열(Compute 2025.3.1, Systems 2025.3.2). 커널 단위 지표와 타임라인 트레이스로 추론 지연을 분해한다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	NVIDIA
정의	Nsight Compute 2025.3.1 · Nsight Systems 2025.3.2 · Visual Profiler · Nsight Eclipse · SDK Manager · nvidia-settings · CUDA 13.0
쓰는 때	GPU가 느릴 때
위치	/opt/nvidia (2.8GB) · /usr/local/cuda-13.0
고른 이유	이미지 생성이 왜 느린지 재려면 프로파일러가 필요
사용 방식	Nsight Systems로 타임라인, nvidia-settings로 클럭·메모리 확인

VRAM·커널 시간을 숫자로 본다
드라이버 설정을 직접 만질 수 있다

2.8GB
초보에겐 화면이 어렵다 — 결론만 뽑기 어렵다

보안·권한

nvidia-settings는 드라이버 설정을 바꾼다 — 저장 전 확인

확인 — 측정용

외부에서 열기

Google ChromeGUI브라우저 · 헤드리스 엔진확인

쉬운 풀이 — 보고서·도감이 실제로 어떻게 보이는지 확인하려고

전문 풀이 — 브라우저이자 헤드리스 렌더러. --headless=new --screenshot / --dump-dom으로 이 파이프라인의 시각·구조 검증을 수행한다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Google
정의	브라우저 — 이 파이프라인의 스크린샷·DOM 검사도 Chrome 헤드리스로 한다
쓰는 때	항상
위치	google-chrome-stable
고른 이유	보고서·도감이 실제로 어떻게 보이는지 확인하려고
사용 방식	--headless=new --screenshot 으로 캡처, --dump-dom 으로 구조 확인

검증 도구로 그대로 쓸 수 있다(설치 추가 없음)
PDF·스크린샷 품질이 좋다

탭을 많이 열면 메모리를 크게 먹는다
확장·프로필이 섞이면 재현이 어긋난다

보안·권한

원격 디버깅 포트를 열어두지 않는다

유지 — 검증용

외부에서 열기

Cindy (데스크톱 클라이언트)GUI이 대화가 도는 앱확인

쉬운 풀이 — 내가 지금 이 창에서 너와 대화하고 있다 — 작업의 출발점

전문 풀이 — 에이전트·태스크·플러그인을 한 프로세스에 묶은 데스크톱 클라이언트(0.1.121 Beta). 대화가 곧 태스크 세션이고, MCP·스킬이 여기에 마운트된다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Cindy
정의	에이전트·태스크·플러그인을 한 화면에서 다루는 데스크톱 클라이언트 (0.1.121 Beta)
쓰는 때	항상
위치	cindy (패키지 설치)
고른 이유	내가 지금 이 창에서 너와 대화하고 있다 — 작업의 출발점
사용 방식	앱에서 대화·태스크·설정을 다룬다

에이전트·MCP·스케줄을 한 곳에서
작업 기록이 남는다

베타(0.1.121)
앱이 무거워지면 작업이 같이 느려진다

보안·권한

계정·연결 권한이 앱에 모인다 — 플러그인 설치를 아무거나 하지 않는다

유지 — 작업 창구

아침 보고서 (daily-brief)GUI매일 09:00 창확인

쉬운 풀이 — 터미널을 열지 않아도 아침에 결론부터 보게 하려고

전문 풀이 — GTK3 + WebKit2 창 하나에 보고서·도감·위키 세 뷰를 얹은 리더. 생성은 daily.py가 하고 앱은 표시와 실행 브리지만 담당한다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	내가 만듦
정의	이 보고서·도구 도감·용어 위키를 한 창에 띄우는 GTK+WebKit 프로그램
쓰는 때	매일 09:00
위치	~/.local/bin/daily-brief · ~/dev/daily-report/app/daily_brief.py
고른 이유	터미널을 열지 않아도 아침에 결론부터 보게 하려고
사용 방식	탭 3개(보고서·도구 도감·용어 위키), F5로 재생성, Ctrl+P로 항상 위

스크롤을 줄인 넓은 레이아웃
실측값만 넣는다 — 비면 '없음'

직접 관리해야 한다(업데이트·버그 모두 내 몫)
로그아웃 상태면 팝업이 안 뜬다

보안·권한

로컬 파일만 읽는다 — 외부 전송 없음

유지 — 매일

SlackGUI팀 채팅확인

쉬운 풀이 — 팀 대화가 여기로 온다

전문 풀이 — Electron 팀 메신저(4.52.162). 채널·DM이 작업 알림의 주 경로다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Salesforce
정의	Slack 데스크톱 4.52.162
쓰는 때	연락 올 때
위치	시스템 패키지(slack-desktop) · 설정 ~/.config/Slack
고른 이유	팀 대화가 여기로 온다
사용 방식	앱에서 채널·DM

알림이 한 곳에
파일 공유가 쉽다

집중을 깨는 알림이 많다
검색이 생각보다 약하다

보안·권한

고객·사내 정보가 흐른다 — 화면 공유 시 주의

확인 — 알림만

외부에서 열기

DiscordGUI커뮤니티 채팅확인

쉬운 풀이 — 오픈소스 커뮤니티가 대개 여기 있다

전문 풀이 — Electron 커뮤니티 클라이언트(1.0.162). 오픈소스 프로젝트의 지원 채널이 대개 여기 있다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Discord Inc.
정의	Discord 1.0.162
쓰는 때	가끔
위치	시스템 패키지 · 설정 ~/.config/discord
고른 이유	오픈소스 커뮤니티가 대개 여기 있다
사용 방식	앱에서 서버·DM

커뮤니티 질문이 빠르다
음성 회의가 가볍다

알림이 요란하다
업무용으론 Slack과 겹친다

보안·권한

서버 권한이 넓다 — 모르는 초대 링크를 누르지 않는다

확인 — 가끔

외부에서 열기

RustDeskGUI원격 데스크톱확인

쉬운 풀이 — 다른 컴퓨터를 화면으로 잡을 때(자체 서버 가능)

전문 풀이 — 자체 릴레이를 둘 수 있는 원격 제어 클라이언트(1.5.0). 상대 ID로 세션을 열고 화면·입력을 중계한다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	RustDesk(오픈소스)
정의	원격 제어 클라이언트 1.5.0
쓰는 때	다른 PC 볼 때
위치	시스템 패키지(rustdesk)
고른 이유	다른 컴퓨터를 화면으로 잡을 때(자체 서버 가능)
사용 방식	상대 ID로 연결

오픈소스라 자체 릴레이를 세울 수 있다
가볍다

기본은 공용 릴레이 — 지연·프라이버시
세션 중엔 화면 전체가 노출된다

보안·권한

원격 세션은 곧 그 PC의 권한 — 끝나면 반드시 끊는다

확인 필요

외부에서 열기

TerminatorCLI터미널 분할확인

쉬운 풀이 — 에이전트·서버 로그를 한 화면에서 같이 보려고

전문 풀이 — 터미널 에뮬레이터(2.1.3)에 격자 분할을 얹은 것. 한 창에서 로그·명령·에이전트를 나란히 띄운다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	커뮤니티(오픈소스)
정의	터미널 2.1.3 — 창을 격자로 쪼개 쓴다
쓰는 때	항상
위치	시스템 패키지(terminator)
고른 이유	에이전트·서버 로그를 한 화면에서 같이 보려고
사용 방식	창을 쪼개 로그·명령을 나란히

분할이 자유롭다
레이아웃을 저장할 수 있다

GUI 터미널이라 ssh만 쓰면 과하다
설정이 파일로 흩어진다

보안·권한

명령 기록이 남는다 — 민감한 값은 프롬프트로 받는다

확인 — 항상

외부에서 열기

VimCLI터미널 편집기확인

쉬운 풀이 — ssh 안에서 파일 한 줄 고칠 때 GUI 편집기를 못 띄운다

전문 풀이 — 터미널 모달 편집기. ssh 세션에서 GUI 없이 파일을 고치는 최소 경로다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	커뮤니티(오픈소스)
정의	터미널 편집기 — 서버에서 파일 고칠 때
쓰는 때	급할 때
위치	시스템 패키지(vim)
고른 이유	ssh 안에서 파일 한 줄 고칠 때 GUI 편집기를 못 띄운다
사용 방식	vim <파일>

어디에나 있다
가볍고 빠르다

손에 안 익으면 오히려 느리다
:wq를 잊으면 파일이 안 저장된다

보안·권한

sudo vim으로 설정을 고치면 소유자가 바뀐다 — 주의

확인 — 비상용

외부에서 열기

minicomCLI시리얼 통신확인

쉬운 풀이 — 로봇·보드가 네트워크 없이 시리얼로만 말할 때

전문 풀이 — 시리얼 터미널(2.9). /dev/ttyUSB0 같은 포트에 보레이트를 맞춰 붙어 보드와 직접 대화한다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	커뮤니티(오픈소스)
정의	시리얼 포트로 장비와 대화하는 프로그램 2.9
쓰는 때	로봇 연결할 때
위치	시스템 패키지(minicom)
고른 이유	로봇·보드가 네트워크 없이 시리얼로만 말할 때
사용 방식	minicom -D /dev/ttyUSB0 -b 115200

드라이버 없이 바로 붙는다
로그를 파일로 남길 수 있다

포트를 점유한다 — 다른 프로그램과 동시 사용 불가
종료 키를 모르면 갇힌다(Ctrl-A, X)

보안·권한

장비 펌웨어를 건드릴 수 있다 — 명령을 확인하고 친다

확인 필요

외부에서 열기

btop++CLI자원 모니터확인

쉬운 풀이 — 이미지 생성 중 VRAM·CPU가 어디까지 차는지 눈으로 보려고

전문 풀이 — TUI 자원 모니터. CPU·RAM·GPU·프로세스를 한 화면에서 갱신하며 VRAM 포화를 눈으로 확인한다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	커뮤니티(오픈소스)
정의	CPU·메모리·GPU·프로세스를 한 화면에 보여 주는 모니터
쓰는 때	느릴 때
위치	시스템 패키지(btop)
고른 이유	이미지 생성 중 VRAM·CPU가 어디까지 차는지 눈으로 보려고
사용 방식	btop 실행

GPU 사용률까지 보인다
터미널에서 바로

읽는 법을 모르면 숫자만 많다
로그를 남기진 않는다

보안·권한

프로세스를 죽일 수 있다 — 실수로 죽이면 작업이 날아간다

확인 — 느릴 때

외부에서 열기

VLCGUI영상 재생확인

쉬운 풀이 — 렌더 결과 영상이 제대로 나왔는지 볼 때

전문 풀이 — 미디어 플레이어(3.0.20). 렌더 결과를 프레임 단위로 훑어 이상 프레임을 찾는다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	VideoLAN
정의	영상 재생기 3.0.20
쓰는 때	가끔
위치	시스템 패키지(vlc)
고른 이유	렌더 결과 영상이 제대로 나왔는지 볼 때
사용 방식	파일을 열어 재생, 프레임 단위 이동

거의 모든 포맷을 연다
프레임 단위로 볼 수 있다

무겁다
코덱 문제를 가끔 스스로 만든다

보안·권한

네트워크 스트림을 열면 외부로 나간다

확인 — 가끔

외부에서 열기

OVBGUIVNC 뷰어확인

쉬운 풀이 — 다른 기계 화면을 VNC로 볼 때

전문 풀이 — Electron VNC 뷰어(/opt/OVB). RFB 프로토콜로 원격 프레임버퍼를 받아 표시한다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	표기 없음 — 확인 필요
정의	Windows·Linux용 VNC 뷰어(Electron)
쓰는 때	확인 필요
위치	/opt/OVB (ovb)
고른 이유	다른 기계 화면을 VNC로 볼 때
사용 방식	/opt/OVB/ovb 실행 후 주소 입력

가볍게 VNC만 본다
설치돼 있음

제작자·버전 표기가 없다 — 확인 필요
사용 기록 없음

보안·권한

VNC는 암호화가 약하다 — 신뢰한 망에서만

확인 필요

KakaoTalkGUI메신저확인

쉬운 풀이 — 국내 연락은 대개 여기로 온다

전문 풀이 — Windows용 카카오톡을 Wine 계열 래퍼로 실행하는 구성 — 데스크톱 항목의 Exec이 env 래퍼를 거친다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Kakao
정의	카카오톡(Windows용을 Wine 계열 래퍼로 실행 — 데스크톱 항목 Exec이 env)
쓰는 때	연락 올 때
위치	데스크톱 항목에 env 래퍼로 등록
고른 이유	국내 연락은 대개 여기로 온다
사용 방식	앱에서 대화

설치돼 있음
국내 협업에선 사실상 표준

Wine 래퍼라 불안정할 수 있다
파일·알림 동작이 네이티브와 다르다

보안·권한

대화 내용이 클라우드로 간다 — 사내 자료 전송 주의

확인 필요

opencodeCLI터미널 에이전트확인

쉬운 풀이 — 터미널에서 도는 오픈소스 코딩 에이전트 — Claude·Codex와 같은 자리를 노린다.

전문 풀이 — 터미널 TUI 코딩 에이전트(~/.opencode/bin). Claude·Codex와 같은 자리를 겨루는 오픈소스 구현이다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	오픈소스 프로젝트(SST 계열)
정의	터미널 코딩 에이전트 — ~/.opencode/bin/opencode
쓰는 때	확인 필요
위치	~/.opencode/bin
고른 이유	모델을 골라 끼울 수 있는 대안
사용 방식	opencode 실행 → TUI에서 대화

모델·프로바이더를 바꿔 끼우기 쉽다
CLI 하나로 완결

이 파이프라인에서는 아직 안 씀
설정이 ~/.opencode 에 따로 쌓인다

보안·권한

에이전트가 로컬 파일을 만진다 — 격리는 bwrap 몫

확인 필요

ROS 2 JazzyCLI + GUI로봇 미들웨어확인 — 486 패키지

쉬운 풀이 — 로봇 코드를 노드로 쪼개 서로 말하게 하는 판. 이 기계 로봇 스택의 뼈대다.

전문 풀이 — ROS 2 Jazzy LTS(486 패키지). 노드·토픽·서비스로 로봇 소프트웨어를 나눠 붙이고, 같은 코드를 시뮬과 실물에 쓴다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Open Robotics(현 OSRF) 재단
정의	ROS 2 Jazzy Jalisco — LTS 배포판, ros2 pkg list 486개
도입	2024-05 배포, 2029-05까지 지원
위치	/opt/ros/jazzy (apt: ros-jazzy-desktop)
고른 이유	센서·제어·계획을 한 덩어리로 짜면 실물과 시뮬을 같이 못 돌린다. 노드로 나누면 같은 코드로 둘 다 돈다.
사용 방식	source /opt/ros/jazzy/setup.bash → ros2 run <패키지> <노드> · ros2 topic echo · colcon build

토픽·서비스·액션 표준이 있어 부품을 갈아 끼울 수 있다
rviz2 로 센서·경로를 눈으로 확인
Gazebo·MoveIt 2·Nav2 가 같은 배포판에 묶여 온다

배포판마다 API 가 바뀐다(재빌드 필요)
DDS 설정·QoS 가 처음엔 어렵다
노드가 늘면 launch 파일이 지저분해진다

보안·권한

DDS 멀티캐스트가 같은 망에 그대로 열린다 — ROS_DOMAIN_ID 로 분리한다
기본은 인증·암호화가 없다(필요하면 SROS2)

채택 — 로봇 미들웨어

외부에서 열기

MoveIt 2CLI + GUI로봇팔 계획·제어확인 — 2.12.4

쉬운 풀이 — 팔을 어디로 어떻게 움직일지 계산하는 쪽. 충돌 회피·역기구학·궤적 생성을 맡는다.

전문 풀이 — MoveIt 2(2.12.4). URDF 기반으로 충돌 회피·역기구학·궤적 계획을 계산하고 RViz 패널에서 목표를 준다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	MoveIt 커뮤니티(PickNik 주도)
정의	moveit_core · moveit_kinematics · moveit_planners_ompl · moveit_msgs
도입	2026-11 기준 2.12.4
위치	/opt/ros/jazzy (apt: ros-jazzy-moveit)
고른 이유	관절 각도 여섯 개를 손으로 풀 수 없다. URDF만 주면 충돌까지 피해 경로를 뽑아 준다.
사용 방식	MoveIt Setup Assistant 로 config 생성 → RViz 의 MotionPlanning 패널에서 목표 지정 → move_group 이 실행

URDF/SRDF 만 있으면 팔 종류를 가리지 않는다
OMPL·CHOMP 등 플래너를 골라 쓸 수 있다
RViz 안에서 목표 자세를 끌어 계획을 눈으로 확인

설정(Setup Assistant)이 길고 한 번 틀리면 원인 찾기 어렵다
실시간 제어에는 부적합 — 계획 후 실행 구조
무거워서 노트북에선 RViz 가 느려진다

보안·권한

계획만 하고 실제 관절로 보내는 건 별도 컨트롤러 — 속도·힘 제한을 반드시 건다
실물 팔에 붙일 때 비상정지 경로를 먼저 확인

채택 — 로봇팔 계획·제어

외부에서 열기

GazeboGUI로봇 시뮬레이터확인 — gz_sim_vendor 0.0.13

쉬운 풀이 — 실물을 깨뜨리기 전에 시뮬에서 먼저 굴린다. 중력·마찰·센서 노이즈까지 넣고 돌린다.

전문 풀이 — Gazebo Sim(ros_gz 1.0.24). SDF 월드에서 물리·센서를 돌리고 ros_gz_bridge 로 ROS 2 토픽에 붙인다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Open Robotics / Gazebo 커뮤니티
정의	Gazebo Sim (ros-jazzy-gz-sim-vendor 0.0.13 · ros_gz 1.0.24, gz_ 패키지 21개)
쓰는 때	ROS 2 Jazzy 와 짝을 이루는 Harmonic 계열
위치	/opt/ros/jazzy/opt/gz_*_vendor
고른 이유	실물 로봇은 한 번 넘어지면 비싸다. 시뮬은 무한히 넘어져도 된다.
사용 방식	gz sim 으로 월드 열기 → ros_gz_bridge 로 ROS 토픽과 연결 → rviz2 로 같이 보기

물리·센서(카메라·라이다·IMU)를 실제와 비슷하게 흉내
ROS 2 토픽과 다리(bridge)로 바로 연결
월드·로봇을 SDF 로 저장해 재현

실물과의 차이(sim-to-real gap)를 결국 메꿔야 한다
GPU·CPU 를 많이 먹는다
렌더 품질이 좋을수록 더 느리다

보안·권한

시뮬은 안전하지만, 시뮬에서 통과한 걸 실물에 그대로 올리지 말 것 — 속도·힘 제한부터
외부 월드/모델을 받아 열면 그 안의 스크립트가 돈다

채택 — 로봇 시뮬레이터

외부에서 열기

MuJoCoCLI물리 엔진확인 — 3.12.0

쉬운 풀이 — 보행·조작 학습을 돌릴 때 제일 많이 쓰는 물리 엔진. 빠르고 미분 가능해서 학습에 유리하다.

전문 풀이 — MuJoCo 3.12.0 물리 엔진. MJCF 로 로봇을 정의하고 수백만 스텝을 빠르게 굴려 보행·조작 정책을 학습한다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Google DeepMind(2021년 공개 후 오픈소스)
정의	MuJoCo 3.12.0 (pip mujoco)
도입	2026-11 기준 3.12.0
위치	python3 -c "import mujoco" (pip 사용자 설치)
고른 이유	강화학습은 수백만 스텝을 도는데, 엔진이 느리면 학습이 안 끝난다.
사용 방식	MJCF(XML)로 로봇 정의 → mujoco.viewer.launch_passive 로 보기 → Gymnasium 환경으로 감싸 학습

접촉·마찰이 안정적이고 빠르다
MJCF 하나로 형상·관성·액추에이터를 정의
파이썬에서 바로 붙는다(별도 설치 프로그램 없음)

GUI 편집기가 없다(XML을 직접 쓴다)
실물 센서·ROS 2 연결은 따로 만들어야 한다
렌더는 단순한 편

보안·권한

pip 패키지 하나로 끝나 외부 통신이 없다
남의 MJCF 를 그대로 돌리면 메시 경로·플러그인을 먼저 확인

채택 — 물리 엔진

외부에서 열기

DockerCLI컨테이너확인 — 29.1.3 (overlayfs)

쉬운 풀이 — 환경이 다른 기계에서도 같은 실행을 보장할 때. ROS 배포판·CUDA 조합을 이미지로 고정한다.

전문 풀이 — Docker Engine 29.1.3. ROS 2 배포판·CUDA·파이썬 조합을 이미지로 고정해 어느 기계에서든 같은 실행을 만든다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Docker Inc.
정의	Docker Engine 29.1.3 — 데몬 실행 중, 스토리지 드라이버 overlayfs
도입	2026-11 기준 29.1.3
위치	/usr/bin/docker (apt: docker.io 계열)
고른 이유	노드버전·파이썬·CUDA 가 얽히면 '내 기계에선 되는데'가 시작된다.
사용 방식	docker run -it --rm image bash · docker build -t 이름 . · docker ps

이미지 하나로 환경을 통째로 재현
지저분한 의존성은 컨테이너 안에 가둔다
GPU 는 --gpus all 로 넘긴다

이미지가 수 GB 로 커진다
GUI 앱은 X 소켓·디스플레이를 따로 넘겨야 한다
데몬이 root 로 돈다

보안·권한

docker 그룹에 넣는 건 사실상 root 권한 — 아무 이미지나 빌드·실행하지 말 것
공식 이미지가 아닌 것은 Dockerfile 을 먼저 읽는다

채택 — 컨테이너

외부에서 열기

uvCLI파이썬 패키지·가상환경확인 — 0.12.10

쉬운 풀이 — pip·venv·pipx 를 한 명령으로 대신한다. 설치가 빨라서 스크립트마다 환경을 새로 만들어도 부담이 없다.

전문 풀이 — uv 0.12.10. venv 생성·패키지 해석·락파일을 한 도구로 처리하고, uvx 로 전역 설치 없이 CLI 도구를 돌린다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Astral(ruff 만든 회사)
정의	uv 0.12.10 (Rust 로 쓴 파이썬 패키지 관리자)
도입	2026-11 기준 0.12.10
위치	~/.local/bin/uv · uvx
고른 이유	pip 은 느리고, venv 관리는 손이 많이 간다. 한 도구로 통일하면 재현이 쉬워진다.
사용 방식	uv venv → uv pip install -r requirements.txt · uvx 도구 로 설치 없이 실행

설치·해석이 pip 보다 훨씬 빠르다
가상환경·파이썬 버전·락파일을 한 도구로
uvx 는 전역 설치 없이 CLI 도구 실행

기존 pip 워크플로와 섞으면 헷갈린다
사내 미러·인증서 설정을 따로 잡아야 할 수 있다

보안·권한

uvx 는 최신 버전을 그때 받아 실행한다 — 버전을 고정해 쓴다
락파일(uv.lock)을 커밋해 재현성을 지킨다

채택 — 파이썬 패키지·가상환경

외부에서 열기

Linear웹 GUI이슈 트래커확인 — Chrome 앱 창

쉬운 풀이 — 할 일을 티켓으로 쪼개 굴릴 때. 데스크톱 앱이 아니라 Chrome 앱 창(PWA)으로 뜬다.

전문 풀이 — Linear 웹 앱을 Chrome 앱 창(전용 프로필)으로 띄운다. 이슈·사이클로 할 일을 티켓 단위로 굴린다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Linear(미국)
정의	Linear 웹 앱 — Chrome --app 창, 전용 프로필
쓰는 때	계속 업데이트(웹)
위치	~/.local/share/applications/linear-app.desktop → linear.app/arobot
고른 이유	메모(Obsidian)와 이슈(Linear)를 나눠 두면 '할 일'과 '아는 것'이 안 섞인다.
사용 방식	앱 창에서 이슈 생성 → 사이클/프로젝트로 묶기 → 단축키로 상태 변경

키보드 중심이라 빠르다
사이클·로드맵으로 일정 관리가 자연스럽다
에이전트(GitHub·Slack) 연동이 잘 된다

데스크톱 앱이 아니라 Chrome 창이다(오프라인 약함)
무료 플랜은 팀 규모 제한
자체 호스팅 불가

보안·권한

브라우저 세션이 곧 로그인 — 전용 프로필을 쓰고 공용 기계에선 로그아웃
외부 연동에 저장소·이슈 내용이 흘러간다

채택 — 이슈 트래커

외부에서 열기

ONLYOFFICEGUI오피스 편집기확인 — 10.0.0 (snap)

쉬운 풀이 — docx·xlsx·pptx 를 열고 고칠 때. 마이크로소프트 포맷 호환이 LibreOffice 보다 나은 편이다.

전문 풀이 — ONLYOFFICE Desktop Editors 10.0.0(snap). docx·xlsx·pptx 서식을 유지한 채 열고 고치고 PDF 로 내보낸다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Ascensio System SIA(라트비아)
정의	ONLYOFFICE Desktop Editors 10.0.0
도입	2026-11 기준 10.0.0
위치	snap: onlyoffice-desktopeditors (/snap/bin)
고른 이유	회사에서 온 docx 를 서식 그대로 열어야 할 때가 있다.
사용 방식	앱 실행 → 파일 열기 → 저장은 원래 포맷 그대로

docx/xlsx/pptx 서식 재현이 좋다
PDF 보기·주석도 된다
오프라인에서 동작

snap 이라 첫 실행이 느리다
한글 폰트·수식은 환경에 따라 깨진다
무거운 편(수백 MB)

보안·권한

문서를 클라우드에 올리지 않는 한 외부 통신 없음
매크로가 든 xlsx 는 열지 말 것

채택 — 오피스 편집기

외부에서 열기

TelegramGUI메신저확인 — 7.3.3 (snap)

쉬운 풀이 — 봇·파일 전송·알림 채널로 쓴다. 2GB 파일과 봇 API 가 있어 자동화에 붙이기 쉽다.

전문 풀이 — Telegram Desktop 7.3.3(snap). 봇 API·대용량 파일 전송으로 알림과 산출물 전달 창구로 쓴다.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	Telegram FZ-LLC
정의	Telegram Desktop 7.3.3
도입	2026-11 기준 7.3.3
위치	snap: telegram-desktop (/snap/bin)
고른 이유	알림·파일을 사람이 보는 창구이자 봇 알림 통로.
사용 방식	앱 로그인 → 봇과 대화 → 파일 끌어다 보내기

큰 파일 전송이 된다
봇 API 가 단순해 스크립트에 붙이기 쉽다
데스크톱·모바일 동기화

snap 이라 테마·트레이 통합이 어색하다
알림이 기본으로 시끄럽다
비공개 채널도 서버를 거친다

보안·권한

비밀 대화가 아닌 한 종단간 암호화가 아니다
봇 토큰은 파일에 두지 않는다

채택 — 메신저

외부에서 열기

geditGUI텍스트 편집기확인 — 46.2

쉬운 풀이 — 잠깐 설정 파일 한 줄 고칠 때. 터미널 편집기를 열지 않아도 되는 가벼운 창.

전문 풀이 — gedit 46.2. 설정 파일·데스크톱 항목을 GUI 로 즉시 열어 고치는 가벼운 편집기.

기본 정보육하원칙 — 누가 · 무엇 · 언제 · 어디서 · 왜 · 어떻게

개발사	GNOME
정의	gedit 46.2 — GNOME 기본 텍스트 편집기
도입	2026-11 기준 46.2
위치	/usr/bin/gedit (apt)
고른 이유	GUI 로 열어야 하는 파일(데스크톱 항목·JSON)을 빠르게 고친다.
사용 방식	gedit 파일 또는 파일 관리자에서 열기 → 저장

가볍고 즉시 뜬다
UTF-8·줄번호·찾기 기본 제공
sudo 없이 쓰는 사용자 영역 편집에 충분

대형 파일에서는 느리다
플러그인 생태계가 사실상 멈췄다
프로젝트 단위 작업엔 부적합

보안·권한

root 로 열면 그 창이 곧 root 편집기 — sudo gedit 은 피한다

채택 — 텍스트 편집기

외부에서 열기

아직 설치 안 한 후보18개

지금은 없지만 이 파이프라인에 붙이면 바로 쓸 것들 — 설치 명령은 이 기계에서 확인한 것만 적었다.

fzf검색~2MB

터미널에서 아무 목록이나 골라주는 퍼지 검색.

파일·브랜치·세션을 눈으로 골라 넘길 때. 에이전트에게 경로를 부를 일이 줄어든다.

외부에서 열기 0.44.1 (apt 확인)

bat보기~10MB

cat 대신 색·줄번호로 보여주는 파일 뷰어.

diff·로그를 눈으로 빨리 훑을 때. cat보다 읽기 편하다.

외부에서 열기 0.24.0 (apt 확인)

lazygitgit~20MB

git을 화면에서 누르는 TUI. 스테이징·리베이스가 클릭 몇 번.

워크트리·브랜치가 여러 개로 늘어나면 CLI보다 빨라진다.

외부에서 열기 apt 없음

ollama로컬 모델모델별 수 GB

모델을 내려받아 내 PC에서 돌리는 실행기.

ComfyUI처럼 클라우드 없이. 요약·분류 같은 작은 일을 무료로 돌릴 때.

외부에서 열기 설치 스크립트 응답 200 확인

nvitopGPU~5MB

GPU 사용률·VRAM·프로세스를 실시간으로 보여주는 모니터.

이미지 생성이 왜 느린지, VRAM이 얼마나 차는지 btop보다 정확히 보인다.

외부에서 열기 1.7.2 (PyPI 확인)

hyperfine측정~2MB

명령이 몇 초 걸렸는지 반복 측정해 통계로 보여준다.

'빨라진 것 같다'를 숫자로. 렌더·스크립트 비교에 쓴다.

외부에서 열기 1.18.0 (apt 확인)

yt-dlp미디어~15MB

영상·오디오를 내려받는 CLI.

참고 영상을 로컬로 받아 프레임을 뽑거나 자막을 볼 때.

외부에서 열기 2026.10.26 (PyPI 확인)

tmux터미널~1MB

터미널 세션을 유지하고 여러 창으로 나누는 프로그램.

ssh가 끊겨도 돌던 작업이 살아 있다 — 긴 빌드·에이전트 실행에 안전.

외부에서 열기 3.4 (apt 확인)

ripgrep검색~5MB

grep보다 빠른 코드·문서 검색. .gitignore는 알아서 건너뛴다.

에이전트에게 "그 문자열 어디 있지"를 물을 때. 큰 저장소도 몇 초에 끝난다.

외부에서 열기 14.1.0 (apt 확인)

fd검색~3MB

find보다 짧게 쓰는 파일 찾기. 이름 일부만 쳐도 된다.

깊이 모르는 폴더에서 파일을 훑을 때. 경로 규칙을 외우지 않아도 된다.

외부에서 열기 9.0.0 (apt 확인)

zoxide탐색~1MB

한 번 간 폴더를 기억해 두고 'z 이름'으로 바로 이동.

프로젝트가 여럿일 때 cd 경로를 매번 치지 않으려고. 쓴 만큼 똑똑해진다.

외부에서 열기 0.9.3 (apt 확인)

git-delta깃~3MB

git diff를 나란히, 색과 줄 번호까지 붙여 읽기 좋게 보여준다.

커밋 전에 무엇이 바뀌었는지 눈으로 확인할 때. 로그·blame도 같이 예뻐진다.

외부에서 열기 0.16.5 (apt 확인)

ncdu디스크~1MB

터미널에서 폴더를 눌러 들어가며 용량을 보는 도구.

디스크가 왜 찼는지 모를 때. 큰 폴더를 눈으로 찾아 바로 지울 수 있다.

외부에서 열기 1.19 (apt 확인)

duf디스크~5MB

마운트된 디스크의 남은 공간을 표로 한 번에 보여준다.

빌드가 실패해 용량 부족이 의심될 때. df보다 읽기 쉽고 색으로 위험을 표시한다.

외부에서 열기 0.8.1 (apt 확인)

eza파일~2MB

ls를 대신하는 목록 보기 — 아이콘·권한·깃 상태까지 한 줄에.

폴더를 자주 들여다볼 때. 어떤 파일이 수정됐는지 색과 표시로 바로 보인다.

외부에서 열기 0.18.2 (apt 확인)

hexyl바이너리~1MB

바이너리 파일을 색으로 구분해 보여주는 16진 뷰어.

이미지·실행 파일 머리말을 확인할 때. 어떤 바이트가 문자인지 색으로 갈린다.

외부에서 열기 0.8.0 (apt 확인)

Isaac Lab로봇Isaac Sim 본체 수 GB + 의존성

엔비디아가 만든 로봇 학습 프레임워크 — Isaac Sim 위에서 수천 환경을 GPU로 동시에 굴린다.

보행·조작 정책을 강화학습으로 뽑을 때. MuJoCo보다 병렬 환경 수가 압도적이다.

외부에서 열기 v3.0.0 (2026-10-20 공개 · GitHub releases 확인)

LeRobot로봇~100MB + 모델 가중치

허깅페이스의 로봇 학습 라이브러리 — 데이터셋·정책·실기 연결이 한 세트.

팔 하나를 직접 텔레오퍼레이션으로 가르쳐 정책을 학습시키는 흐름을 가장 짧게 만든다.

외부에서 열기 0.6.1 (PyPI 확인 · python ≥3.12)

MCP 서버17종 · 연결돼 돌아가는 서버

모델이 직접 부를 수 있는 외부 도구 묶음. 지금 연결된 것만 적었다 — 목록은 세션마다 달라진다.

스킬44종 · 모델이 읽는 지시문

서버가 아니라 문서다 — 특정 상황에서 어떻게 일할지 적어둔 절차. 필요할 때만 로드된다.