---
title: "agent-crew"
url: "https://claudemods.dev/ko/builds/agent-crew-6ba7e2"
source: "https://github.com/bekir1184/agent-crew"
source_type: "github"
repo: "https://github.com/bekir1184/agent-crew"
author: "bekir1184"
author_handle: "bekir1184"
stars: 2
category: "대시보드 및 HUD"
categories: ["hud"]
tags: ["cost-tracking", "hooks", "monitoring", "pixel-art", "statusline", "subagents"]
permission_level: 2
scan_complete: true
install: "claude plugin marketplace add bekir1184/agent-crew\nclaude plugin install agent-crew@agent-crew"
added: "2026-10-09T20:08:19.970Z"
updated: "2026-10-09T15:55:51Z"
locale: "ko"
content_locale: "ko"
---

# agent-crew

프롬프트 위에 픽셀 아트 Claude 크루 멤버로 하위 에이전트를 표시합니다: 각 에이전트가 무엇을 하는지, 얼마나 진행되었는지, 얼마나 많은 토큰을 사용했는지 보여줍니다.

## Description

Agent Crew는 하위 에이전트를 프롬프트 위에 작은 픽셀 아트 크루로 렌더링하는 Claude Code 플러그인입니다. `/plugin install agent-crew --marketplace bekir1184/agent-crew`로 설치하며, 하위 에이전트가 실행될 때마다 자동으로 작동합니다.

주요 기능:
- 프레임이 있는 AGENT 라인: Claude의 실시간 활동(검색, 읽기, 생각, 쓰기, 테스트 실행)과 토큰 및 도구 수가 포함된 한 줄 턴 요약을 표시합니다.
- 하위 에이전트당 한 행, 실행되는 모델로 레이블이 지정되며, 도우미는 부모 아래에 중첩됩니다. 바쁠 때 행이 접힙니다.
- 사용 중인 각 도구에 대한 애니메이션 크리처 상태, 개별 생각 애니메이션, 에이전트가 권한을 기다릴 때 노란색 "승인 필요" 버블.
- 행당 상세 확장 가능 패널: 전체 작업, 할 일 목록, 건드린 파일, 토큰 세부 내역, 실행 요약.
- 과거 실행 시간에서 도출된 남은 시간 추정. 모델 호출 없음, 토큰 비용 없음.
- 정직한 토큰 계산: 에이전트 자체의 읽기/쓰기 토큰만 표시되며, 캐시 및 재읽기 토큰은 별도의 세부 정보 줄에 유지됩니다.
- 설정을 통한 선택적 예상 비용 표시.

명령어: `/crew`(가시성 토글), `/crew demo`(30초 데모), `/crew clear`(스테이지 초기화). 설정은 `/plugin configure agent-crew@agent-crew`에 있습니다. 터미널에서는 행이 색상 점으로 나타나며 `ctrl+x tab`으로 탐색할 수 있습니다.

개발: `claude --plugin-dir .`로 실행, `claude plugin validate .`로 검증, `claude plugin test .`로 테스트. 애니메이션 문서 이미지는 `node scripts/docs.mjs`로 다시 그려집니다. MIT 라이선스, Claude Code >= 2.1.293 필요.

## Install

```
claude plugin marketplace add bekir1184/agent-crew
claude plugin install agent-crew@agent-crew
```

## Original README

<h1 align="center">Agent Crew</h1>

<p align="center"><b>Your subagents, as a tiny pixel crew above the prompt.</b><br>
See who is doing what, how far along they are, and how long is left.</p>

<p align="center">
  <img src="docs/demo.gif" alt="Agent Crew in the Claude desktop app: Claude starts alone on the AGENT line, then a Plan, an Explore and a General agent arrive one by one with a helper; they search, read, think and ask for approval, their bars fill up, and each raises a checkered flag when done" width="100%">
</p>

<p align="center">
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT license"></a>
  <img src="https://img.shields.io/badge/Claude%20Code-%E2%89%A5%202.1.293-d97757" alt="Claude Code 2.1.293 or newer">
</p>

## Install

```
/plugin install agent-crew --marketplace bekir1184/agent-crew
```

That's it. The crew shows up by itself whenever Claude is at work. Want a look right now? Type `/crew demo`.

**Costs nothing.** Agent Crew never calls a model and never touches your prompts: it only watches.

## Claude, live

While Claude works, the framed line shows what it's doing this very second. When the turn ends it shrinks to one quiet line with the totals. Press the arrow to see what happened.

<img src="docs/agent-line.svg" alt="The AGENT line: searching, reading, thinking, writing, running tests, then a thin line: done, last turn 0:37, 5.6k tokens, 9 tools" width="100%">

## The crew

When Claude hands work to subagents, they line up below, one row each. Each row names the model it runs on, so you can tell Opus from Haiku at a glance. Helpers started by a subagent tuck in under their parent. Too busy? The arrow on the title folds them away.

Each critter holds the tool it's using:

<img src="docs/crew-states.svg" alt="Searching with a magnifier, reading a page, writing in a code window, running a command on a laptop, browsing a globe, getting ready in a hard hat, done with a checkered flag, failed with dizzy eyes, cancelled and asleep" width="100%">

## Thinking...

Thinking is where agents spend most of their time, so the critters keep it lively: an hourglass, a thought cloud with a question mark, a lightbulb that lights up. Each one at its own pace.

<img src="docs/thinking.svg" alt="Three critters thinking: one turns an hourglass, one fills a thought cloud with a question mark, one lights a bulb and hops" width="100%">

## It needs you

When an agent stops to ask for permission, it says so: a yellow question bubble, and the title tells you how many are waiting.

<img src="docs/approval.svg" alt="A row turns yellow with Needs approval: Bash rm -r build, then carries on once approved" width="100%">

## The details

Every row has an arrow. It opens everything the row had no room for: the full task, its to-do list, the files it touched, and its tokens.

<img src="docs/details.svg" alt="A row opens into a panel: task, current step, checklist, changed files, token breakdown and run summary" width="100%">

## How long is left?

No model is asked and no tokens are spent: Agent Crew simply remembers how long this kind of agent took before.

<img src="docs/estimate.svg" alt="Past run times, the middle one picked, a live countdown, and a re-estimate when the run goes long" width="100%">

## Honest tokens

A row shows what the agent's own work took: what it read in and what it wrote. Nothing else.

Claude also keeps the whole conversation in a cache and re-reads it on every request. And after a break the cache expires, so the next request writes the whole conversation into it again, which on a long conversation can be hundreds of thousands of tokens at once. Neither is the agent's work, so neither inflates the row: both sit in the details panel, on their own line.

Turn on **Show estimated cost** in the settings and each row also gets a ≈ dollar figure.

## Commands

| | |
| --- | --- |
| `/crew` | Hide or show the crew |
| `/crew demo` | A 30-second show: Claude starts alone, the crew arrives, thinks, asks you, and ends with all flags up |
| `/crew clear` | Clear the stage |

**Settings** live in `/plugin configure agent-crew@agent-crew`: show Claude's own line (on), show estimated cost (off).

**In the terminal** there's no pixel art, just a colored dot per row. Press `ctrl+x tab` to reach the crew, then the letter on an arrow: `h` for the title, `a`, `b`, `c` for the rows.

## Development

Run it from a clone, then check and test it (Claude Code 2.1.293 or newer):

```bash
claude --plugin-dir .
claude plugin validate .
claude plugin test .
```

The animated images in `docs/` and `site/` are drawn from the mod's own pixel art: `node scripts/docs.mjs` (Node 25+) redraws them.

---

<p align="center">Made for fun. <a href="LICENSE">MIT</a> © 2026 Bekir Ersever</p>
