JuliusBrussee/caveman
🪨 tại sao lại sử dụng nhiều token khi ít token làm thủ thuật — Claude Code kỹ năng cắt 65% token bằng cách nói chuyện như người thượng cổ
README
tại sao lại sử dụng nhiều mã thông báo khi ít người làm thủ thuật
Kỹ năng gốc khiến đại lý ít nói. Caveman 2 cũng khiến họ đọc ít hơn.
Mã thông báo đầu vào do nhà cung cấp báo cáo ít hơn 33,2% trong điểm chuẩn Claude Code được ghim. benchmark_counterfactual
Giữ đại lý của bạn. Não lớn. Bối cảnh nhỏ.
Xem nó · cài đặt · Tìm hiểu · ủy nhiệm · Pixel · Bọc · Tài liệu · Giấy phép
Xem nó
| 🗣️ Đại lý bình thường — 69 token | |
|---|---|
|
|
cài đặt
Hai sản phẩm. Chọn một hoặc cả hai.
1 · Lưu đầu vào — Caveman Proxy thu nhỏ những gì đại lý của bạn đọc trước mỗi cuộc gọi của nhà cung cấp, với khả năng khôi phục chính xác theo byte. Thời gian chạy BSL-1.1, MIT CLI.
npm install -g @caveman-ai/cli && caveman setup --install
caveman claude # or codex · gemini · aider · opencode · hermes · openclaw
2 · Lưu kết quả - kỹ năng, bản gốc. Đại lý của bạn câu trả lời nói một cách chặt chẽ về người thượng cổ trong khi mã, lệnh và lỗi vẫn chính xác. MIT, hơn 30 đại lý.
npx skills add JuliusBrussee/caveman
Những cách khác trong — trình cài đặt đầy đủ có hook, Windows, chỉ một tác nhân
Trình cài đặt đầy đủ cũng nối dây móc nối Claude Code và dòng trạng thái, tìm mọi tác nhân được hỗ trợ trên máy của bạn và có thể chạy lại một cách an toàn (Node.js 18+):
curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/v2.3.1/install.sh | bash
Windows (PowerShell 5.1+):
irm https://raw.githubusercontent.com/JuliusBrussee/caveman/v2.3.1/install.ps1 | iex
Chỉ một đại lý:
# Claude Code
claude plugin marketplace add JuliusBrussee/caveman && claude plugin install caveman@caveman
# Gemini CLI
gemini extensions install https://github.com/JuliusBrussee/caveman
# Codex, Cursor, Windsurf, Cline, and other skills-compatible agents
npx skills add JuliusBrussee/caveman --skill '*' -a codex --yes # replace codex with your agent profile
Ma trận đầy đủ hơn 30 tác nhân, chạy thử, gắn cờ, xác minh và gỡ cài đặt: CÀI ĐẶT.md.
Mã thông báo của bạn đi đâu
Bạn có lịch sử đại lý hàng tháng trên đĩa. caveman learn đọc nó và chấm điểm thiết lập của bạn. Địa phương, chỉ đọc, không có tài khoản.
caveman learn # Claude Code + Codex + Gemini CLI + opencode; aider via CAVEMAN_AIDER_ROOT
Báo cáo hiển thị Điểm Cave của bạn, mọi mức chìm mã thông báo được xếp hạng theo luồng với bản sửa lỗi một dòng phía sau mỗi hàng, mức độ sâu của mỗi phiên trong cửa sổ ngữ cảnh của nó, bản phát lại những gì bản sửa lỗi sẽ cắt giảm từ các phiên trước đây của bạn và minh họa giá niêm yết về chi phí của các lần chìm được xếp hạng trong 30 ngày.
caveman learn implement # hand the plan to Claude Code or Codex
learn implement mở đại lý của riêng bạn với kế hoạch và caveman-learn kỹ năng hướng dẫn nó đề xuất từng cách khắc phục dưới dạng khác biệt, chỉ áp dụng khi bạn có, đo lại và hoàn nguyên bất kỳ điều gì không làm giảm mã thông báo mỗi lượt. Caveman không bao giờ làm cho đại lý của bạn trở nên ngu ngốc hơn để làm cho nó rẻ hơn.
Proxy Thượng Cổ
Một lệnh bao bọc đại lý của bạn và định tuyến lưu lượng truy cập của nhà cung cấp thông qua proxy cục bộ được cung cấp bởi Caveman Engine. Trong điểm chuẩn Claude Code 54 lần chạy được ghim, nó đã sử dụng Mã thông báo đầu vào do nhà cung cấp báo cáo ít hơn 33,2% hơn trực tiếp Claude Code trong khi vượt qua tất cả 18 lần kiểm tra câu trả lời chính xác. Phương pháp, kết quả từng trường hợp và giới hạn. benchmark_counterfactual
Không thay đổi mã, không có phần phụ trợ Caveman: proxy chuyển tiếp từng yêu cầu đến nhà cung cấp mà bạn đã chọn và các bản sao khôi phục vẫn nằm trên đĩa của bạn. Thông tin xác thực Claude Pro/Max OAuth chuyển tới Anthropic nguyên trạng.
caveman claude # Claude Code + Codex + Gemini CLI + opencode; aider via CAVEMAN_AIDER_ROOT
Động cơ làm gì với tải trọng — detect() nhập từng tải trọng, sau đó định tuyến nó đến một máy nén để lưu giữ những câu trả lời phụ thuộc vào:
| Loại được phát hiện | Giữ | Mục tiêu tiết kiệm |
|---|---|---|
json |
khóa, cấu trúc, cây con lỗi/thông báo; thu gọn mảng lặp đi lặp lại | 70–90% |
log |
lỗi, dấu vết ngăn xếp, dòng đầu tiên/cuối cùng; giảm thông tin và tiếng ồn tiến trình | 85–95% |
code |
nhập khẩu, chữ ký, chủng loại; bỏ qua các thân hàm, cú pháp vẫn hợp lệ | 40–70% |
diff |
tiêu đề tập tin/hunk và các dòng đã thay đổi; bối cảnh lặp lại của elide | 60–80% |
search-result |
lượt truy cập trên/dưới cùng với lượt truy cập chẩn đoán/bảo mật | 80–95% |
text /HTML |
tiêu đề, ngữ cảnh mở/kết, các phần quan trọng | 50–80% |
contextwindow.Pack() Ngoài ra, điều chỉnh bối cảnh ứng viên phù hợp với ngân sách mã thông báo theo mức độ liên quan, lần truy cập gần đây và tín hiệu lỗi của BM25, được trả về theo thứ tự ban đầu để trình tự thời gian vẫn tồn tại.
Động cơ tương tự cung cấp năng lượng cho một tập hợp các động từ:
caveman learn # scan your real agent history → score + ranked token sinks
caveman learn implement # fix the findings with your own agent, consent-gated per edit
caveman explore install # read-only FastContext subagent: finds code as path:line
caveman shrink -- pnpm test # compress noisy command output, byte-exact recoverable
caveman browse <url> # local Chrome over a compressed a11y tree
caveman mem remember|recall # durable memory; `mem recover <handle>` = original bytes
caveman trial -- claude # A/B a real session, then `trial report`
caveman toon encode|decode # the TOON re-encoder, standalone
caveman stats # what caveman actually did, by content type
Máy chủ MCP hiển thị năm công cụ cho bất kỳ máy chủ MCP nào: caveman_compress, caveman_retrieve, caveman_stats, caveman_toon_encode, caveman_toon_decode.
Khi duyệt (cần Chrome): truy vấn tập trung vào chi phí của bảng thao tác 200 hàng 121 token, nhỏ hơn 129,8× so với đường cơ sở ARIA của Nhà viết kịch là 15.704. Phương pháp đầy đủ: browse/BENCHMARK.md.
Chế độ pixel
Kỹ năng như hình ảnh
Vòng tròn đầy đủ: động cơ bây giờ nén thứ mà người tiền sử đã bắt đầu. Mỗi kỹ năng quan trọng mà bạn cài đặt sẽ tải lại toàn bộ nội dung nhắc nhở của nó sau mỗi lần gọi và bạn phải trả khoản thuế đó mãi mãi. caveman convert hiển thị từng cài đặt SKILL.md body sang các trang PNG tại chỗ. Frontmatter vẫn giữ nguyên văn bản nên tính năng khám phá và kích hoạt hoạt động chính xác như trước; người mẫu đọc cơ thể dưới dạng hình ảnh.
caveman convert --dry-run # every installed skill, with the token math, no writes
caveman convert --agent claude # convert the profitable ones
caveman convert --revert # byte-identical restore from SKILL.orig.md
Được đo lường dựa trên kỹ năng thượng cổ: 1.069 → 415 token ước tính, −61%. Chuyển đổi chỉ kích hoạt khi các trang đánh bại văn bản; bất kỳ lỗi nào sẽ khiến byte kỹ năng giống hệt nhau và đặt tên cho cổng nói không. Các kỹ năng mới được cài đặt thông qua caveman skills install pixel tự động theo mặc định (--no-pixel để chọn không tham gia).
kỹ năng
Nguyên gốc và vẫn là cách nhanh nhất để cảm nhận người tiền sử. MIT mãi mãi. Hoạt động ở Claude Code, Codex, Gemini, Cursor, Windsurf, Cline, Copilot và hơn 30 đại lý khác.
Loại /caveman nếu đại lý của bạn không tự động kích hoạt nó. Chuyển đổi với /caveman lite|full|ultra|wenyan-lite|wenyan-full|wenyan-ultra; tắt nó đi với /caveman off hoặc normal mode.
Một lần cài đặt cũng mang đến những công cụ nhỏ:
| Công cụ/lệnh | Những gì bạn nhận được |
|---|---|
/caveman [lite|full|ultra|wenyan-lite|wenyan-full|wenyan-ultra|off] |
Trả lời ngắn hơn ở cường độ bạn chọn. |
cavecrew-investigator, cavecrew-builder, cavecrew-reviewer |
Các cài đặt trước của tác nhân phụ được nén để định vị, chỉnh sửa và xem lại mã. |
/caveman-commit |
Thông báo cam kết thông thường Terse. |
/caveman-review |
Kết quả đánh giá một dòng, có thể hành động. |
/caveman-compress <file> |
Các tệp bộ nhớ Markdown nhỏ hơn, có bản sao lưu gốc. |
/caveman-stats |
Mức sử dụng mã thông báo phiên cục bộ và mức tiết kiệm ước tính trong Claude Code. |
/caveman-help |
Lời nhắc trên một màn hình về mọi chế độ và lệnh. |
investigate-first, lean-build, surgical-patch, safe-refactor, migration, verify-and-stop |
Mô hình làm việc viết ít mã hơn, do đó, đại lý lập hóa đơn ít mã thông báo hơn. Đại diện của bạn sẽ tự mình xử lý những việc này khi có nhiệm vụ phù hợp. |
/caveman-setup, /caveman-discover, /caveman-learn, /caveman-manage, /caveman-optimize, /caveman-explore, /caveman-evidence-review |
Điều khiển công cụ thượng cổ và proxy: thiết lập nó, tìm nơi mã thông báo đi, hành động theo những gì nó tìm thấy. |
| Nhiệm vụ | Bình thường | người thượng cổ | Đã lưu |
|---|---|---|---|
| Giải thích lỗi kết xuất lại React | 1180 | 159 | 87% |
| Sửa lỗi hết hạn mã thông báo phần mềm trung gian xác thực | 704 | 121 | 83% |
| Thiết lập nhóm kết nối PostgreSQL | 2347 | 380 | 84% |
| Giải thích git rebase vs merge | 702 | 292 | 58% |
| Tái cấu trúc lệnh gọi lại thành async/await | 387 | 301 | 22% |
| Kiến trúc: microservices vs monolith | 446 | 310 | 30% |
| Xem xét PR về vấn đề bảo mật | 678 | 398 | 41% |
| Docker bản dựng nhiều giai đoạn | 1042 | 290 | 72% |
| Gỡ lỗi điều kiện chạy đua PostgreSQL | 1200 | 232 | 81% |
| Triển khai ranh giới lỗi React | 3454 | 456 | 87% |
| trung bình | 1214 | 294 | 65% |
[! QUAN TRỌNG] Cảnh báo số trung thực. Kỹ năng chỉ co lại đầu ra mã thông báo. Mã thông báo đầu vào và lý luận không bị ảnh hưởng và bản thân kỹ năng này sẽ thêm ~ 1–1,5k mã thông báo đầu vào mỗi lượt. Khoản tiết kiệm trong cả phiên hoạt động nhỏ hơn số lượng đầu ra và đối với khối lượng công việc vốn đã ngắn gọn, chúng có thể trở thành âm ròng. Chiến thắng thực sự là khả năng đọc và tốc độ; tiết kiệm chi phí là tiền thưởng. Khi nào người thượng cổ thắng, khi nào thua và cách tự mình đo lường: docs/TRUNG THỰC-SỐ.md.
Bọc bất kỳ đại lý
caveman <agent> bao bọc tám đại lý nguyên bản. Thêm một là thay đổi dữ liệu, một cấu hình JSON duy nhất trong agents/profiles/, không có mã.
| đại lý | nhà cung cấp | Nó được bọc như thế nào |
|---|---|---|
| Claude Code | Anthropic | vars env |
| OpenAI Codex CLI | OpenAI | env vars (phím API) · phù du CODEX_HOME (ChatGPT đăng nhập) |
| Gemini CLI | vars env | |
| Người trợ giúp | OpenAI/Anthropic | vars env |
| mã mở | sst | cấu hình nội tuyến thông qua env, của bạn opencode.json nguyên vẹn |
| Đại lý Hermes | Nghiên cứu Nous | --provider custom + env |
| OpenClaw | OpenClaw | cấu hình được hợp nhất tạm thời, cấu hình của bạn chỉ đọc |
| Pi | pi.dev | tiện ích mở rộng gốc đi kèm, của bạn ~/.pi cấu hình nguyên vẹn |
Wrap không bao giờ chỉnh sửa tập tin cấu hình của riêng bạn. Chuyến đi khứ hồi phiên thực ở chế độ ghi, được kiểm tra dựa trên Hermes v0.18.0, OpenClaw 2026.6.11và Pi 0,84,2.
Không có trong danh sách? Trỏ bất kỳ nhà cung cấp SDK hoặc khung nào (Vercel AI SDK, LangChain, LiteLLM, OpenAI Agents, CrewAI, PydanticAI) vào proxy cục bộ bằng một baseURL trao đổi: integrations/recipes/.
Gói mặc định trao cho tác nhân toàn bộ quá trình tải: năm công cụ thượng cổ MCP, máy chủ duyệt MCP khi Chrome phân giải, đầu ra lệnh thu gọn thông qua một hook thực trên Claude, mã mở, Gemini, Hermes và OpenClaw (Codex nhận được một ghi chú mềm trung thực, thời gian chạy của nó từ chối việc viết lại: OpenAI/codex#18491) và kỹ năng như hình ảnh về cài đặt kỹ năng mới. Tắt các phần trong ~/.caveman-cloud/config.json.
Toàn bộ hang động
Một ý tưởng. Đại lý làm được nhiều hơn với ít hơn.
| Repo | Những gì nó co lại | Trạng thái |
|---|---|---|
| người thượng cổ (bạn ở đây) | Đại lý gì nói, và bây giờ nó là gì đọc | sống |
| duyệt thượng cổ | Đại lý gì nhìn thấy trong trình duyệt | sống |
| thượng cổ-đại lý-SDK | Đại lý sản xuất của bạn là gì tải, cuộc gọi và chi tiêu | kho lưu trữ riêng · trong nhà phát triển |
| hang động | Sự nén nướng thành tạ (Gemma tinh chỉnh) | phòng thí nghiệm |
| mã thượng cổ | các toàn bộ đại lý, từ đầu đến cuối | đông lạnh |
| hang động | Đại lý gì nhớ lại, qua các phiên | đông lạnh |
| bộ đồ trước đó | các xây dựng vòng lặp, hướng theo thông số kỹ thuật | đông lạnh |
Các kho lưu trữ đông lạnh vẫn cài đặt và hoạt động; họ không còn phát triển tích cực nữa. Những ý tưởng hay nhất của họ vẫn tồn tại ở đây: lõi bộ nhớ nén của Cavemem đưa vào bên trong người thượng cổ, và bài học về mật mã thượng cổ đã trở thành caveman wrap. Làm cho đại lý bạn đã sử dụng rẻ hơn thay vì thay thế nó.
Caveman làm cho token nhỏ. Caveman Cloud làm được điều đó có thể chứng minh được.
Báo cáo kết quả thời gian chạy cục bộ inferred; báo cáo kết quả điểm chuẩn được kiểm soát benchmark_counterfactual. Không phải là hóa đơn của nhà cung cấp. Caveman Cloud là nơi có thể trở thành bằng chứng trực tiếp đủ điều kiện verified: đường cơ sở ở chế độ ghi, các thay đổi đằng sau cổng đánh giá, khôi phục do mất chất lượng, tiết kiệm từ lưu lượng truy cập thực với biên lai đã ký. Người thượng cổ ngoại tuyến không bao giờ nói verified.
Tham gia danh sách chờ → Caveman.so
Quyền riêng tư
Đại lý của bạn vẫn nói chuyện với nhà cung cấp mà bạn đã chọn. Nén cục bộ không cần tài khoản Caveman. các caveman CLI gửi số liệu thống kê sử dụng ẩn danh theo mặc định: lệnh nào đã chạy, cộng với mã thông báo được tính và cắt. Không bao giờ có lời nhắc, mã hoặc đường dẫn tệp của bạn. Nó báo như vậy trong lần chạy đầu tiên và một lệnh sẽ tắt nó vĩnh viễn: caveman telemetry off (hoặc DO_NOT_TRACK=1). Skill và hook chạy cục bộ; proxy chuyển tiếp lưu lượng truy cập của nhà cung cấp; CCR nằm trong tệp SQLite trên đĩa của bạn. Ranh giới mạng, đo từ xa và lưu trữ chính xác: BẢO MẬT.md.
Giấy phép
Chia giấy phép. Bề mặt kỹ năng và áp dụng là MIT. Thời gian chạy được liên kết với công cụ có sẵn nguồn BSL-1.1, không phải Nguồn mở OSI trước Ngày thay đổi.
MIT — kỹ năng, Tác nhân SDK và trình khởi tạo, CLI, cả SDK khách (TS + Python), bộ công cụ, evals/người chấm điểm, hợp đồng, danh mục nhà cung cấp, trình bao mở rộng và ứng dụng khách Cavemem mỏng.
BSL-1.1 — Công cụ, Proxy, Công cụ bộ nhớ đệm, trình ghi lại, Duyệt, máy chủ MCP, shrink, lõi Cavemem Go và nền tảng Go được chia sẻ. Các mô-đun thời gian chạy được liên kết với Engine mới mặc định là BSL-1.1. Nguồn có sẵn: đọc nó, phân nhánh nó, tự lưu trữ nó để có lưu lượng truy cập bên thứ nhất miễn phí, bao gồm cả quá trình sản xuất. Mọi phiên bản BSL đều tự động chuyển đổi sang Apache-2.0 vào trước đó của 2030-06-21 hoặc bốn năm sau khi phiên bản đó xuất xưởng lần đầu tiên. Việc sử dụng dịch vụ được lưu trữ, quản lý hoặc nhúng của bên thứ ba cần có giấy phép thương mại. Văn bản BSL và bản đồ mỗi thư mục được gửi cùng với nguồn.
engine/pixel nhúng ống dẫn nước (MIT) cộng với các bản đồ glyph có nguồn gốc từ Spleen 5×8 (BSD-2-Clause) và GNU Unifont (ngoại lệ OFL-1.1 / GPLv2 kép với phông chữ kép); nó NOTICE đi cùng với nguồn đó.
"Caveman" và logo đá là thương hiệu của Julius Brussee. "Powered by Caveman" là ổn nếu đúng.
Gắn dấu sao cho kho lưu trữ này
Caveman tiết kiệm mã thông báo cho bạn, giúp bạn tiết kiệm tiền. Giá sao bằng không. Thương mại công bằng. ⭐
Tài liệu: Hướng dẫn kỹ thuật · Ma trận cài đặt · Những con số trung thực · Giấy phép · Đóng góp · Hướng dẫn bảo trì · vấn đề
Kỹ năng MIT · Công cụ BSL-1.1 — ít mã thông báo. không nói dối.
Dự án cùng danh mục
Thiết lập và chạy với Kimi-K2.6, GLM-5.2, MiniMax, DeepSeek, gpt-oss, Qwen, Gemma và các mẫu khác.
f.k.a. Lời nhắc ChatGPT tuyệt vời. Chia sẻ, khám phá và thu thập lời nhắc từ cộng đồng. Nguồn mở và miễn phí — tự lưu trữ cho tổ chức của bạn với sự riêng tư hoàn toàn.
🤗 Transformers: khung định nghĩa mô hình cho các mô hình học máy tiên tiến ở dạng văn bản, hình ảnh, âm thanh và mô hình đa phương thức, cho cả suy luận và đào tạo.
Giao diện AI thân thiện với người dùng (Hỗ trợ Ollama, OpenAI API, ...)
Suy luận LLM trong C/C++
21 bài học, bắt đầu xây dựng bằng AI sáng tạo
