설치Install
Ferrorium/제품Products/ctx
ctx 0.1.0 · 무료Free · macOS · Linux

에이전트가 읽던 487KB, 54KB면 충분했다Your agent read 487 KB. 54 KB was enough.

에이전트에게 cat·grep·find·git log 대신 ctx 를 쓰게 하세요. 파일 구조와 줄번호는 남기고 나머지는 접어서, 에이전트가 읽는 출력이 84~97% 줄어듭니다.Have your agent call ctx instead of cat, grep, find and git log. It keeps the structure and line numbers, folds the rest, and your agent reads 84–97% less.

curl -fsSL https://ctx.ferrorium.com/install.sh | sh

설치 경로installs to ~/.local/bin/ctxSHA-256 자동 검증verified설치 스크립트 보기View install script바이너리 직접 받기Download binaries

01 · Benchmark

같은 작업인데 읽을 양은 84~97% 적습니다Same task, 84–97% less to read

기존 명령과 ctx 로 같은 작업을 돌리고 출력 바이트를 쟀습니다. 네 작업 모두 84.2~96.6% 줄었고, 에이전트가 읽는 토큰도 그만큼 줄어듭니다.We ran the same task with the standard command and with ctx, then counted output bytes. All four shrank by 84.2–96.6%, and so does what your agent has to read.

공개 저장소 rtk-ai/rtk 태그 dev-0.50.1-rc.456, 저장소 루트에서 wc -c 로 측정. ctx 만 설치하면 재현할 수 있고, 결과는 코드베이스에 따라 다릅니다. grep 감소분 일부는 파일당 상한에서 나옵니다.Public repo rtk-ai/rtk at tag dev-0.50.1-rc.456, wc -c from the repo root. Reproducible with ctx installed; varies by codebase. Part of the grep gain comes from the per-file cap.
ctx기존 명령Standard기존 출력Beforectx 출력ctx비율Ratio감소Change
ctx grepgrep -rn487,192 B53,762 B−89.0%
ctx outlinecat -n190,645 B20,947 B−89.0%
ctx mapfind20,705 B705 B−96.6%
ctx briefgit status + log9,231 B1,460 B−84.2%
이런 분께 맞습니다Good fit if
✓ 에이전트가 grep 한 번에 컨텍스트를 다 써 버린 적이 있다✓ One grep has eaten your agent's whole context window
✓ 큰 저장소에서 cat 으로 파일 전체를 읽히는 게 아깝다✓ Watching it cat entire files in a big repo hurts
✓ 지침 파일 몇 줄로 끝나는 도구를 원한다✓ You want a fix that is a few lines in an instructions file

02 · Before / After

왼쪽을 전부 읽을 필요가 있었을까요?Did it really need to read all of the left side?

왼쪽은 기존 명령, 오른쪽은 ctx 가 실제로 낸 출력의 앞부분입니다. ctx 는 파일별로 묶고 반복을 접은 뒤, 몇 줄을 뺐는지 숫자로 남깁니다.Left is the standard command, right is ctx. Real output, first lines only. ctx groups by file, folds repeats and tells you exactly how much it left out.

grep -rn 'fn ' src487,192 B
src/learn/detector.rs:19:    pub fn as_str(&self) -> &str {
src/learn/detector.rs:85:pub fn is_command_error(is_error: bool, output: &str) -> bool {
src/learn/detector.rs:106:pub fn classify_error(output: &str) -> ErrorType {
src/learn/detector.rs:133:pub fn extract_base_command(cmd: &str) -> String {
src/learn/detector.rs:154:pub fn command_similarity(a: &str, b: &str) -> f64 {
src/learn/detector.rs:191:fn is_tdd_cycle_error(error_type: &ErrorType, output: &str) -> bool {
src/learn/detector.rs:208:fn differs_only_by_path(a: &str, b: &str) -> bool {
src/learn/detector.rs:222:pub fn find_corrections(commands: &[CommandExecution]) -> Vec<CorrectionPair> {
src/learn/detector.rs:290:fn extract_diff_token(wrong: &str, right: &str) -> String {
src/learn/detector.rs:312:pub fn deduplicate_corrections(pairs: Vec<CorrectionPair>) -> Vec<CorrectionRule> {
… 6,007 lines more
ctx grep 'fn ' src53,762 B · −89.0%
── src/main.rs (103 hits)
1518| fn run_bunx_tool(args: &[String], verbose: u8, skip_env: bool) -> Result<i32> {
1531| fn configured_awareness_level() -> core::config::AwarenessLevel {
1545| fn run_fallback(parse_error: clap::Error) -> Result<i32> {
1729| fn shell_split(input: &str) -> Vec<String> {
1733| fn build_k8s_namespace_args(namespace: Option<String>, all: bool) -> Vec<String> {
1744| fn build_k8s_logs_args(pod: String, container: Option<String>) -> Vec<String> {
1765| fn pnpm_global_flags(recursive: bool, workspace_root: bool) -> Vec<String> {
1777| fn merge_pnpm_args(
… +95 more
── src/analytics/ccusage.rs (13 hits)
94| fn binary_exists() -> bool {
[113 files, 5942 hits, 840 shown, 5102 capped, 75 dup-collapsed]

세 데모 모두 rtk-ai/rtk 태그 dev-0.50.1-rc.456 의 저장소 루트에서 실행했습니다. 바이트 수는 전체 출력을 wc -c 로 잰 값입니다.All three ran at the root of rtk-ai/rtk, tag dev-0.50.1-rc.456. Byte counts are wc -c of the full output.

03 · Commands

손에 익은 명령 여덟 개, 이름만 바뀝니다Eight commands you know, new names

에이전트가 이미 쓰는 탐색 명령을 하나씩 바꿔 줍니다. 플래그도 거의 그대로라 새로 익힐 게 없습니다.Each one replaces a command your agent already runs. The flags look the same, so there is nothing new to learn.

  • ctx outline

    본문은 접고 함수·타입 시그니처만 줄번호와 함께 보여 줍니다. 줄번호가 건너뛴 자리가 생략한 구간입니다.Signatures with line numbers. Bodies are elided, and gaps show as line jumps.

    대체replaces cat -n
    기능 제안Suggest a feature
  • ctx grep

    결과를 파일별로 묶고, 같은 줄은 접고, 파일마다 상한을 둡니다. -E -i -w -C -l -e 를 지원하고 기본은 리터럴 검색입니다.Grouped by file, duplicate lines folded, per-file cap. Supports -E -i -w -C -l -e; literal by default.

    대체replaces grep -rn · rg
    기능 제안Suggest a feature
  • ctx read

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

    대체replaces sed -n A,Bp
    기능 제안Suggest a feature
  • ctx def

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

    대체replaces grep + read
    기능 제안Suggest a feature
  • ctx map

    확장자 분포와 용량이 큰 디렉터리를 보여 줍니다. 여러 루트를 한 번에 넘겨도 됩니다.Extension histogram and largest directories, for several roots at once.

    대체replaces find · ls -R
    기능 제안Suggest a feature
  • ctx brief

    세션을 시작할 때 브랜치, 변경 파일, 최근 커밋, 파일 분포를 한 화면에 요약합니다.One screen at session start: branch, changed files, recent commits, file mix.

    대체replaces git status + log + ls
    기능 제안Suggest a feature
  • ctx wrap

    빌드와 테스트를 대신 실행하고 출력만 압축합니다. 종료 코드는 그대로 돌려줍니다.Runs a build or test, compresses the output, keeps the exit code.

    대체replaces cmd | tail
    기능 제안Suggest a feature
  • ctx web · fetch

    Brave와 Bing 결과를 합쳐 검색하고, 페이지는 본문만 마크다운으로 가져옵니다. API 키가 필요 없습니다.Metasearch over Brave and Bing, plus readable page bodies as markdown. No API key.

    대체replaces 웹 검색 · 페이지 읽기
    기능 제안Suggest a feature

04 · Setup

에이전트에 붙이는 데 3분이면 됩니다Three minutes to wire it in

설치하고 지침 파일에 규칙 몇 줄을 붙여 넣으면 끝입니다. 팀 전체에 깔고 싶다면 도입 문의를 남겨 주세요.Install it, paste a few lines into your agent instructions, and you are done. Rolling it out to a whole team? Ask us.
팀/기업 도입 문의Team adoption

  1. 01

    설치Install

    curl -fsSL https://ctx.ferrorium.com/install.sh | sh 를 실행합니다. 기본 경로는 ~/.local/bin/ctx 입니다.Run curl -fsSL https://ctx.ferrorium.com/install.sh | sh. Installs to ~/.local/bin/ctx.

  2. 02

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

    CLAUDE.md 나 AGENTS.md 에 오른쪽 대체 규칙을 그대로 붙여 넣습니다.Paste the mapping on the right into CLAUDE.md or AGENTS.md.

  3. 03

    평소처럼 작업Work as usual

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

CLAUDE.md / AGENTS.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 start → 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.

05 · Download

스크립트 대신 파일로 받고 싶다면Rather grab the file yourself?

ctx 0.1.0 빌드를 그대로 올려 두었습니다. 압축을 풀고 ctx 를 PATH 에 두면 됩니다. 설치 스크립트도 같은 파일을 받아 SHA-256 을 검증합니다.Prebuilt ctx 0.1.0. Extract and put ctx on your PATH. The install script fetches the same files and verifies SHA-256.

플랫폼Platform파일File크기Size받기Get
macOS Apple Siliconaarch64-apple-darwinctx-aarch64-apple-darwin.tar.gzsha256 c0bccbd9e01f9ca3…0.4 MB다운로드Download.sha256
macOS Intelx86_64-apple-darwinctx-x86_64-apple-darwin.tar.gzsha256 ecc96e852a412f0a…0.4 MB다운로드Download.sha256
Linux x86_64x86_64-unknown-linux-muslctx-x86_64-unknown-linux-musl.tar.gzsha256 778f61b16b5d1c0c…0.5 MB다운로드Download.sha256
Linux arm64aarch64-unknown-linux-muslctx-aarch64-unknown-linux-musl.tar.gzsha256 95dbbc0631756895…0.4 MB다운로드Download.sha256
검증Verify: shasum -a 256 -c ctx-<target>.tar.gz.sha256
새 버전 알림 받기Get release alerts
최신 버전 고정 주소Latest alias: https://ctx.ferrorium.com/dl/latest/ctx-<target>.tar.gz

06 · FAQ

설치하다 막히면 여기부터 보세요Stuck? Start here

여기 없는 문제가 생기거나 출력이 이상하면 버그로 알려 주세요.Not covered here, or the output looks wrong? Tell us.

버그 신고Report a bug
ctx 는 어떻게 설치하나요?How do I install ctx?
터미널에서 curl -fsSL https://ctx.ferrorium.com/install.sh | sh 한 줄을 실행하면 됩니다. 스크립트가 OS·CPU 를 감지해 맞는 바이너리를 받고, SHA-256 을 검증한 뒤 ~/.local/bin/ctx 에 설치합니다. 설치가 끝나면 ctx --version 으로 확인하세요.Run curl -fsSL https://ctx.ferrorium.com/install.sh | sh. The script detects your OS and CPU, downloads the matching binary, verifies SHA-256 and installs to ~/.local/bin/ctx. Check with ctx --version.
설치했는데 ctx: command not found 가 나옵니다.I get “ctx: command not found” after installing.
~/.local/bin 이 PATH 에 없어서입니다. 설치 스크립트가 마지막에 안내하는 대로 셸 설정 파일(~/.zshrc 또는 ~/.bashrc)에 export PATH="$HOME/.local/bin:$PATH" 를 추가하고 새 터미널을 여세요.~/.local/bin is not on your PATH. Add export PATH="$HOME/.local/bin:$PATH" to ~/.zshrc or ~/.bashrc and open a new terminal.
설치 위치나 버전을 바꿀 수 있나요?Can I change the install directory or version?
네. 환경변수 두 개를 씁니다. CTX_INSTALL_DIR 은 설치 디렉터리(기본 ~/.local/bin), CTX_VERSION 은 버전(기본 latest, 예: v0.1.0)입니다. 예: curl -fsSL https://ctx.ferrorium.com/install.sh | CTX_VERSION=v0.1.0 CTX_INSTALL_DIR=/usr/local/bin shYes. CTX_INSTALL_DIR sets the directory (default ~/.local/bin) and CTX_VERSION pins a version (default latest, e.g. v0.1.0). Example: curl -fsSL https://ctx.ferrorium.com/install.sh | CTX_VERSION=v0.1.0 CTX_INSTALL_DIR=/usr/local/bin sh
스크립트를 실행하기 전에 내용을 확인할 수 있나요?Can I read the script before running it?
네. install.sh 는 40줄 남짓한 POSIX sh 스크립트입니다. 직접 받으려면 아래 다운로드 표에서 tar.gz 와 .sha256 을 받아 shasum -a 256 -c 로 검증한 뒤 압축을 풀어 PATH 에 두면 됩니다.Yes. install.sh is a short POSIX sh script. Or download the tar.gz and .sha256 from the table below, verify with shasum -a 256 -c, extract and put ctx on your PATH.
어떤 OS 를 지원하나요? Windows 는요?Which platforms are supported? Windows?
macOS(Apple Silicon·Intel)와 Linux(x86_64·arm64)용 단일 바이너리를 제공합니다. Windows 네이티브 빌드는 없습니다. WSL 에서는 Linux 로 인식돼 Linux 바이너리가 설치됩니다. web·fetch 는 시스템 curl 을 씁니다.Single binaries for macOS (Apple Silicon, Intel) and Linux (x86_64, arm64). No native Windows build; under WSL the Linux binary is installed. web/fetch use the system curl.
업데이트와 삭제는 어떻게 하나요?How do I update or uninstall?
업데이트는 설치 명령을 다시 실행하면 최신 버전으로 덮어씁니다. 삭제는 바이너리 파일 하나만 지우면 됩니다: rm ~/.local/bin/ctxRe-run the install command to update. To uninstall, delete the single binary: rm ~/.local/bin/ctx
어떤 에이전트에서 쓰나요?Which agents does it work with?
셸 명령을 실행할 수 있는 에이전트라면 다 됩니다. Claude Code, Codex CLI, Gemini CLI 등에서 CLAUDE.md·AGENTS.md 같은 지침 파일에 ctx 규칙을 적어 두면 에이전트가 기존 명령 대신 ctx 를 부릅니다.Any agent that runs shell commands: Claude Code, Codex CLI, Gemini CLI and others. Put the ctx rules in CLAUDE.md or AGENTS.md.
출력을 줄이면 정보가 빠지지 않나요?Does it drop information?
outline 과 grep 은 생략한 구간을 줄번호와 '+N more' 로 표시합니다. 에이전트는 필요한 부분만 ctx read 로 다시 읽습니다. 상한이 필요 없으면 grep -n N 으로 늘릴 수 있습니다.Elided ranges are marked with line numbers or '+N more', so the agent reads exactly what it needs next with ctx read. Raise the cap with grep -n N.
절감 수치는 어떻게 쟀나요?How was the benchmark measured?
공개 저장소 rtk-ai/rtk 의 태그 dev-0.50.1-rc.456 을 받아 저장소 루트에서 두 명령의 출력을 wc -c 로 비교했습니다. ctx 만 설치하면 누구나 재현할 수 있고, 결과는 코드베이스에 따라 다릅니다. grep 감소분 일부는 파일당 상한에서 나옵니다.Public repo rtk-ai/rtk at tag dev-0.50.1-rc.456: both commands run from the repo root, output compared with wc -c. Reproducible with ctx installed; results vary by codebase. Part of the grep gain comes from the per-file cap.
비용과 라이선스는?Cost and license?
무료입니다. 개인이든 회사든 같습니다. 빌드한 바이너리만 배포하고 소스는 공개하지 않습니다.Free. Only prebuilt binaries are distributed; the source is private.

07 · Apply

써 보고 할 말이 생기면 알려 주세요Tried it? Tell us what you think

팀 도입, 기능 제안, 버그 신고, 새 버전 알림 모두 이 폼 하나로 받습니다. 영업일 2일 안에 메일로 답장합니다.One form for team adoption, feature ideas, bug reports and release alerts. We reply by email within two business days.

입력한 정보는 문의 회신 목적으로만 사용합니다.Used only to reply to your request.

다음 세션부터, 에이전트가 덜 읽게From your next session, your agent reads less

설치 한 줄, 지침 파일 몇 줄이면 됩니다. 무료입니다.One install line and a few lines of instructions. Free.

curl -fsSL https://ctx.ferrorium.com/install.sh | sh