본문 바로가기
Ferrorium by 폴라앱
ctx 0.1.0 · 2026-09 공개Released 2026-09

에이전트 출력,
필요한 만큼만.Agent output,
only what matters.

ctx 는 AI 코딩 에이전트가 cat, grep, find, git log 대신 쓰는 CLI 입니다. 구조와 위치만 남기고 나머지를 접어 컨텍스트 창을 아낍니다.ctx is a CLI that AI coding agents use instead of cat, grep, find and git log. It keeps structure and locations and folds the rest.

curl -fsSL https://ctx.ferrorium.com/install.sh | sh
macOS · Linux설치 스크립트 보기View install script릴리스 바이너리Release binariesGitHub
MIT 오픈소스open source단일 Rust 바이너리single Rust binary크레이트 의존성crate deps 0

같은 작업, 출력 바이트Same task, output bytes

공개 저장소 rtk-ai/rtk · 적을수록 좋음Public repo rtk-ai/rtk · lower is better

기존 명령standard commandctx
grepvs grep -rn
−90.8%
outlinevs cat -n
−85.6%
mapvs find
−97.6%
briefvs git
−78.3%
커밋 323b797 · 2026-09-25 · wc -c · grep 감소분 일부는 파일당 8건 상한에서 나옴commit 323b797 · 2026-09-25 · wc -c · part of the grep gain comes from the per-file cap재현하기reproduce
Before / After

실제 출력을 나란히Real output, side by side

아래는 실제 명령을 실행해 얻은 출력입니다. 왼쪽이 기존 명령, 오른쪽이 ctx 입니다. 바이트 수는 전체 출력 기준입니다.Actual output from real commands. Left: the standard command. Right: ctx. Byte counts are for the full output.

grep -rn 'fn ' src510,497 B
ctx grep 'fn ' src47,214 B

grep·map 은 rtk-ai/rtk, outline 은 ctx 저장소의 src/re.rs 에서 실행했습니다. 화면에는 앞부분만 보입니다.grep/map ran on rtk-ai/rtk, outline on src/re.rs in the ctx repo. Only the first lines are shown.

Commands

익숙한 명령을 하나씩 대체합니다A drop-in for the commands agents already run

ctx outline

함수·타입 시그니처만 줄번호와 함께. 본문은 줄번호 점프로 생략 구간을 드러냅니다.Signatures only, with line numbers. Bodies are elided.

대체replaces · cat -n

ctx grep

파일별 그룹, 같은 줄 접기, 파일당 상한. -E -i -w -C -l -e 지원, 기본은 리터럴.Grouped by file, duplicate lines folded, per-file cap.

대체replaces · grep -rn · rg

ctx read

여러 파일의 줄 범위를 한 번의 호출로 읽습니다.Read ranges from many files in one call.

대체replaces · sed -n A,Bp

ctx def

심볼 정의부터 블록 끝까지 한 번에 꺼냅니다.A symbol's definition through the end of its block.

대체replaces · grep + read

ctx map

확장자 분포와 용량 상위 디렉터리. 여러 루트를 한 번에.Extension histogram and largest directories.

대체replaces · find · ls -R

ctx brief

세션 시작용 저장소 요약: 브랜치, 변경, 최근 커밋, 파일 분포.Repo snapshot for the start of a session.

대체replaces · git status + log + ls

ctx wrap

빌드·테스트를 직접 실행하고 출력만 압축합니다. 종료 코드는 그대로.Runs a command, compresses output, keeps the exit code.

대체replaces · cmd | tail

ctx web · fetch

Brave·Bing 결과를 융합하는 메타서치, 본문만 마크다운으로. API 키 불필요.Metasearch and readable page bodies. No API key.

대체replaces · 웹 검색 · 페이지 읽기

Setup

3분이면 에이전트에 붙습니다Wire it into your agent in minutes

  1. 설치Install

    curl 한 줄 또는 Homebrew. 기본 경로는 ~/.local/bin/ctx 입니다.One curl line or Homebrew. Installs to ~/.local/bin/ctx.

  2. 지침 파일에 규칙 추가Add rules to your agent file

    CLAUDE.md 나 AGENTS.md 에 대체 규칙을 적습니다. 오른쪽 예시를 그대로 붙여도 됩니다.Put the mapping in CLAUDE.md or AGENTS.md. The snippet on the right works as is.

  3. 평소처럼 작업Work as usual

    에이전트가 탐색할 때 ctx 를 부르고, 빌드·테스트는 ctx wrap 으로 실행합니다.The agent calls ctx while exploring and runs builds through ctx wrap.

CLAUDE.md
## Search & Read - cat -n → ctx outline <file> - sed -n A,Bp → ctx read f1 A-B f2 A-B - grep / rg → ctx grep <pat> <ROOT> - find → ctx map <ROOT> - session → ctx brief <ROOT> - build/test → ctx wrap -- <cmd> - web search → ctx web "<query>" - read a page → ctx fetch <url> Batch many files and patterns into one call.
FAQ

자주 묻는 질문Questions

어떤 에이전트에서 쓰나요?Which agents does it work with?

셸 명령을 실행하는 에이전트라면 모두 됩니다. Claude Code, Codex CLI, Gemini CLI 등에서 CLAUDE.md·AGENTS.md 같은 지침 파일에 ctx 사용 규칙을 적어 두면 에이전트가 기존 명령 대신 ctx 를 부릅니다.Any agent that runs shell commands. Put the ctx rules in your CLAUDE.md or AGENTS.md.

정보가 빠지지 않나요?Does it drop information?

outline 과 grep 은 생략한 구간을 줄번호와 '+N more' 로 표시합니다. 에이전트는 필요한 부분만 ctx read 로 다시 읽습니다. 캡이 필요 없으면 grep -n N 으로 늘릴 수 있습니다.Elided ranges are always marked with line numbers or '+N more', so the agent can read exactly what it needs next.

벤치 수치는 어떻게 쟀나요?How was the benchmark measured?

공개 저장소 rtk-ai/rtk (커밋 323b797) 에서 같은 작업의 표준 출력 바이트 수를 wc -c 로 비교했습니다(2026-09-25). 저장소의 bench.sh 로 누구나 재현할 수 있고, 결과는 코드베이스에 따라 달라집니다.Stdout byte counts on rtk-ai/rtk @323b797 via wc -c. Reproduce with bench.sh; results vary by codebase.

무엇이 필요한가요?Requirements?

macOS(Apple Silicon·Intel) 또는 Linux(x86_64·arm64). 단일 정적 바이너리이고 외부 크레이트 의존성이 없습니다. web·fetch 는 시스템 curl 을 씁니다.macOS or Linux. A single binary with zero crate dependencies; web/fetch use system curl.

비용과 라이선스는?Cost and license?

무료, MIT 라이선스 오픈소스입니다.Free and open source under MIT.

다음 세션부터 바로 써 보세요Try it in your next session

curl -fsSL https://ctx.ferrorium.com/install.sh | sh
GitHub이슈·문의Issues