AI 에이전트 구조, 농장 화면으로 보기 — 터미널 탭은 일꾼, 폴더는 밭 (무료 '터미널 농장' 소개)

10월 10, 2026

클로드 코드나 코덱스를 터미널 여러 개에 띄워 두고 일하다 보면 "지금 어느 창이 일하는 중이고, 어느 창이 내 대답을 기다리고 있지?" 하고 헷갈릴 때가 많습니다. A 작업 지시를 엉뚱한 C 창에 넣기도 하고요. 거기에 스킬, 메모리, 도구, 컨텍스트 같은 말까지 섞이면 비개발자에게는 더 어렵게 느껴집니다.

이번에는 이 구조를 픽셀 농장 화면으로 보여 주는 무료 오픈소스 「터미널 농장(Terminal Farm)」을 소개하고, 농장 비유로 AI 에이전트가 어떻게 일하는지 정리해 드리겠습니다. 동료나 수강생에게 에이전트를 설명할 때도 그대로 쓸 수 있습니다.

🌾Terminal Farm (GitHub, 무료 · MIT)클로드 코드 등 코딩 에이전트 세션을 농장 화면으로 보여 주는 로컬 대시보드. 설치 안내(INSTALL.md) 포함.https://github.com/ceokobec-hue/terminal-farm바로가기 ↗

도구 정보

무엇	내 컴퓨터에서 돌아가는 에이전트 세션 현황판 (외부로 보내는 데이터 없음, 127.0.0.1에서만 동작)
지원	Claude Code, Codex, OpenCode, Cursor 등 터미널 에이전트
운영체제	macOS 터미널에서 기능 전부 (탭 이동·새 대화) / Windows·Linux는 보기 전용
준비물	Node.js 22.13 이상, 클로드 코드 같은 에이전트 CLI
원작	Jarren Rocks의 Bot Crossing(MIT)을 고쳐 만든 버전 — 원작 출처가 함께 표시됩니다

카드뉴스로 먼저 보기

카드를 좌우로 밀거나 ← → 키, 아래 점으로 넘길 수 있어요

1. 농장으로 보는 AI 에이전트 구조

에이전트를 잘 짜 주는 거창한 설정(흔히 "하네스"라고 부르는 것)이 없어도 요즘 클로드 코드는 기본 상태로 꽤 잘 일합니다. 그래도 무엇이 어디에 있고 어떻게 오가는지는 알아 두는 게 좋습니다. 그래야 문제가 생겼을 때 어디를 고칠지 보이니까요.

농장에서	실제로는	한 줄 설명
🧑‍🌾 일꾼	터미널 탭 하나 (세션)	클로드 코드나 코덱스 한 개가 일꾼 한 명
🟫 밭	레포 (프로젝트 폴더)	코드·문서·작업 지시서가 담기는 폴더 하나
📋 게시판	CLAUDE.md · AGENTS.md	"이 폴더에서는 이렇게 일해" 규칙. 짧을수록 좋아요
📦 창고	스킬 · 메모리 · 도구	여러 일꾼이 같이 꺼내 쓰는 공용 자원
🛤️ 흙길·수로	레포끼리 연결	영상 편집 폴더 + 홍보 폴더처럼 두 밭을 함께 쓰는 일
🌱 작물	컨텍스트 (대화 맥락)	대화가 길어질수록 밭이 차 오름
🧺 수확 상자	압축 (/compact)	가득 차면 요약해서 상자에 담고 새로 시작

🛠️스킬

같은 순서로 반복되는 일을 적어 둔 작업 설명서. "매번 이렇게 해" 하는 일이 있으면 스킬로 만들어 두세요.

레시피

🧠메모리

지난번에 했던 일과 다시는 하지 말 것. "다음부터는 항상 검토표를 먼저 보여 줘" 같은 것.

기억

🔧도구

내가 직접 만들었거나 받아 둔 스크립트·프로그램. 일꾼이 필요할 때 가져다 씁니다.

연장

2. 화면에서 바로 알 수 있는 것

⏳기다리는 일꾼

내 대답을 기다리는 세션에는 말풍선 알림이 뜹니다. N 키로 다음 대기 세션으로 바로 이동.

대기

🟢일하는 밭

작업 중인 밭과 쉬는 밭이 색으로 구분돼서 놀고 있는 창이 한눈에 보입니다.

현황

📊현황판

B 키를 누르면 터미널별 상태 목록이 나옵니다. 모델·effort·컨텍스트 사용량도 표시할 수 있어요.

B 키

🗺️구조 투어

T 키를 누르면 일꾼 → 밭 → 게시판 → 창고 순서로 구조 설명 투어가 진행됩니다.

T 키

이런 점은 알고 쓰세요
- Windows·Linux는 보기 전용입니다. 탭 이동, 새 대화 열기는 macOS 터미널에서만 됩니다.
- 농장은 에이전트의 대화 기록과 레포 파일을 읽어서 화면을 그립니다. 밖으로 보내지는 않지만, 만들어지는 data/colony.json(레포 이름·경로)은 남과 공유하지 마세요.
- 상태 줄(statusline)을 켜려면 클로드 코드 설정 파일을 고쳐야 하니 먼저 백업하세요.
- 제작자가 "있는 그대로" 공개한 것이라 질문·버그 대응은 어려울 수 있습니다.

3. 설치와 활용 프롬프트

간단하게 — 클로드 코드에게 설치 맡기기

프롬프트

github.com/ceokobec-hue/terminal-farm 저장소의 INSTALL.md를 읽고, 안내대로 설치해 줘.
설정 파일을 바꾸기 전에는 무엇을 바꾸는지 먼저 보여 주고, 원본을 백업한 다음에 진행해.

조금 더 구체적으로 — 내 폴더 구조를 농장으로 정리해 달라고 하기

프롬프트

내 작업 폴더들을 "농장 비유"로 정리해 줘.

1. 지금 쓰는 프로젝트 폴더(레포) 목록과 각 폴더의 한 줄 설명 → "밭" 목록
2. 각 폴더의 CLAUDE.md(규칙)를 읽고, 15줄이 넘으면 꼭 필요한 규칙만 남기는 수정안 → "게시판" 정리
3. 내가 만든 스킬, 저장된 메모리, 직접 만든 스크립트를 구분한 표 → "창고" 목록
4. 두 폴더 이상을 함께 쓰는 작업이 있으면 어떤 폴더끼리 연결되는지 → "흙길" 목록

파일은 고치지 말고, 표와 수정안만 보여 줘.

제대로 맡기기 — 팀 교육용 설명 자료 만들기

프롬프트

우리 팀(비개발자 [8]명)에게 AI 에이전트 구조를 설명하는 [10]분짜리 자료를 만들어 줘.

- 비유는 "농장": 일꾼=터미널 세션, 밭=프로젝트 폴더, 게시판=규칙 파일, 창고=스킬·메모리·도구, 수확 상자=대화 압축
- 순서: 왜 헷갈리는가(창이 많을 때 생기는 실수 3가지) → 농장 비유 → 우리 팀 폴더로 예시 → 지켜야 할 규칙 3가지
- 규칙 예시: 창 하나에는 일 하나, 규칙 파일은 짧게, 끝나면 저장(커밋)하고 닫기
- 슬라이드 7장 분량의 개요와, 장마다 말할 대본을 3문장씩
- 전문용어는 처음 나올 때 괄호로 쉬운 말을 붙여 줘

4. 이런 분께 먼저 추천합니다

👩‍💼에이전트를 여러 창으로 쓰는 직장인

어느 창이 날 기다리는지 놓치지 않게 됩니다.

실무

👩‍🏫AI 에이전트를 가르치는 강사·교사

"하네스"를 그림 한 장으로 설명할 수 있어요.

교육

🧑‍🤝‍🧑팀에 에이전트를 도입하려는 관리자

폴더·규칙·공용 자원을 같은 말로 이야기할 수 있게 됩니다.

협업

🛰️Bot Crossing (원작, GitHub)터미널 농장의 바탕이 된 오픈소스. 우주 기지 모양의 원래 화면을 볼 수 있습니다.https://github.com/station-sciences/bot-crossing바로가기 ↗

AI 오토마타