{
  "schema": "tesign-radar/item/1",
  "generated_at": "2026-09-17T01:56:13.055Z",
  "lang": "ko",
  "slug": "headroom",
  "url": "https://tesign.com/item/headroom/",
  "alternates": {
    "ko": {
      "html": "https://tesign.com/item/headroom/",
      "json": "https://tesign.com/item/headroom/index.json",
      "markdown": "https://tesign.com/item/headroom/index.md"
    },
    "en": {
      "html": "https://tesign.com/en/item/headroom/",
      "json": "https://tesign.com/en/item/headroom/index.json",
      "markdown": "https://tesign.com/en/item/headroom/index.md"
    }
  },
  "name": "Headroom",
  "use_label": "에이전트가 읽는 것 압축",
  "one_liner": "도구 출력과 로그를 모델에 넣기 전에 줄여 둡니다.",
  "text": {
    "why": "도구 출력과 로그는 대개 그대로 모델에 들어가서, 정작 중요한 맥락이 창 밖으로 밀려납니다. headroom은 그 앞단에 붙어 도구 출력·로그·파일·RAG 청크를 줄인 다음 넘깁니다. 라이브러리·프록시·MCP 서버 세 가지 형태로 붙일 수 있고 Apache-2.0으로 공개돼 있습니다. 저장소 설명은 코딩 에이전트 20%, JSON 60~95% 절감을 내걸지만 이는 저장소 쪽 수치입니다.",
    "take": "에이전트 코드를 안 고치고 프록시로 끼울 수 있어서, 절감 효과를 자기 트래픽으로 먼저 재 보기 좋습니다.",
    "build": [
      "긴 로그를 줄여 넘기는 에이전트 앞단 프록시",
      "토큰 비용을 낮추는 사내 RAG 전처리 단계"
    ],
    "who": [
      {
        "role": "개발자",
        "situation": "긴 로그·도구 출력이 컨텍스트를 밀어낼 때"
      },
      {
        "role": "인프라 담당자",
        "situation": "팀 전체 토큰 비용을 앞단에서 줄일 때"
      },
      {
        "role": "RAG 개발자",
        "situation": "검색 청크를 모델에 넣기 전에 줄일 때"
      }
    ],
    "start": [
      {
        "command": true,
        "text": "pip install \"headroom-ai[all]\""
      },
      {
        "command": true,
        "text": "headroom wrap claude"
      },
      {
        "command": true,
        "text": "headroom doctor"
      },
      {
        "command": false,
        "text": "코드 수정 없는 프록시 모드:"
      },
      {
        "command": true,
        "text": "headroom proxy --port 8787"
      }
    ],
    "caveat": [
      "wrap 명령은 Serena를 사용자 범위에 함께 설치합니다(--code-memory none으로 생략)",
      "Intel 맥은 네이티브 휠이 없어 Docker 설치를 권합니다",
      "절감 수치는 저장소 자체 벤치마크이며 반복적인 데이터일수록 큽니다"
    ]
  },
  "cta": {
    "type": "use_package",
    "label": "USE PACKAGE",
    "url": "https://docs.headroomlabs.ai/docs"
  },
  "ready": "developer",
  "categories": [
    "ai",
    "library"
  ],
  "categories_confirmed": true,
  "tags": [
    "context",
    "tokens",
    "mcp"
  ],
  "platform": [
    "windows",
    "macos",
    "linux",
    "cli"
  ],
  "license": {
    "spdx": "Apache-2.0",
    "scope": "permissive",
    "scope_text": "상업 이용·수정·재배포 가능. 고지 유지, 바꾼 부분은 표시.",
    "url": "https://spdx.org/licenses/Apache-2.0.html",
    "note": null,
    "open_source": true
  },
  "language": "Python",
  "source_urls": {
    "canonical": "https://docs.headroomlabs.ai/docs",
    "github": "https://github.com/headroomlabs-ai/headroom",
    "huggingface": null,
    "app_store": null,
    "sightings": [
      {
        "source": "github",
        "url": "https://github.com/headroomlabs-ai/headroom",
        "posted_at": "2026-09-13T01:00:00.000Z",
        "hn_url": null
      }
    ]
  },
  "numbers": {
    "as_of": "2026-09-16T21:00:00.000Z",
    "stars": 72323,
    "stars_unit": "GitHub stars",
    "stars_checked_at": "2026-09-15T19:34:21.488Z",
    "stars_observed_since_check": 6,
    "star_delta_24h": 6,
    "star_delta_7d": 185,
    "star_delta_30d": 318,
    "star_delta_unit": "GitHub stars gained in the window, GH Archive events summed to as_of",
    "spark_14d": [
      null,
      36,
      35,
      33,
      24,
      null,
      9,
      17,
      60,
      42,
      18,
      11,
      27,
      6
    ],
    "hf_likes": null,
    "hf_likes_observed_at": null,
    "hn_points": null,
    "hn_points_observed_at": null,
    "store": null,
    "method": "별 총합 = GitHub에서 마지막으로 확인한 값(stars_checked_at) + 그 뒤 GH Archive에서 관측한 증가. 24h·7d·30d 증가는 GH Archive 시간별 이벤트를 기준 시각(as_of)까지 합한 값. 우리 점수는 없습니다."
  },
  "ranks": {
    "as_of": "2026-09-16T21:00:00.000Z",
    "all_time": 77,
    "rising": {
      "24h": null,
      "7d": null,
      "30d": 64
    },
    "categories": []
  },
  "activity": {
    "pushed_at": "2026-09-15T04:39:29.000Z",
    "owner_type": "Organization",
    "open_issues": 654,
    "contributors": 265,
    "releases_count": 169,
    "latest_release": {
      "tag": "v0.37.0",
      "published_at": "2026-08-27T21:18:26.000Z",
      "prerelease": false
    },
    "checked_at": "2026-09-15T19:34:21.488Z",
    "core_checked_at": "2026-09-15T19:34:21.488Z"
  },
  "signals": [],
  "images": {
    "og": "https://tesign.com/img/headroom-9b4b13570c.png",
    "cover": "https://tesign.com/img/headroom-9b4b13570c.png",
    "cover_width": 2400,
    "cover_height": 1260,
    "gallery": [
      "https://tesign.com/img/headroom-9b4b13570c.png"
    ],
    "alt": "Headroom 문서 사이트 소개 페이지. 왼쪽 목차와 본문, 아래에 TypeScript compress 호출 코드 미리보기가 있습니다.",
    "tier": 1
  },
  "dates": {
    "first_seen_at": "2026-09-13T07:43:42.354Z",
    "source_created_at": "2026-01-07T19:58:51.000Z",
    "discovery_hours": 5963.747598333333,
    "launch_signal_at": "2026-09-13T01:00:00.000Z",
    "kept_at": "2026-09-13T11:32:21.628Z",
    "first_published_at": "2026-09-13T11:32:21.881Z",
    "updated_at": "2026-09-15T04:36:56.880Z",
    "ingestion_mode": "live"
  },
  "notes": [
    "이 파일은 tesign.com 항목 페이지와 같은 빌드에서 같은 데이터로 만들어졌습니다. 소개 글은 편집자가 쓴 것이고, 숫자는 저장된 관측값입니다.",
    "JSON의 null은 관측하지 않았다는 뜻입니다 — 0이 아닙니다. 마크다운에서는 [확인 필요]로 적습니다.",
    "별 총합 = GitHub에서 마지막으로 확인한 값(stars_checked_at) + 그 뒤 GH Archive에서 관측한 증가. 24h·7d·30d 증가는 GH Archive 시간별 이벤트를 기준 시각(as_of)까지 합한 값. 우리 점수는 없습니다.",
    "요약이며 법적 조언이 아닙니다."
  ]
}