Skip to content

About

No description, website, or topics provided.

Resources

Stars

4 stars

Watchers

1 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

agentic-kit

Nothing you did with Claude gets lost.
Nothing it did stays a guess.

For people who work in Claude Code all day: find any past chat, see what really happened in it, and check an agent's work before it ships.

Find any chat  ◦  See what Claude really sent  ◦  Skills that check your work  ◦  Web pages word for word  ◦  All your accounts behind one claude  ◦  One install, one undo

What it does • Install • Measured • What you can pick • What changes • Without setup

for Claude Code install with uv license platforms


What it does for you

Every chat you have with Claude Code is saved on your machine, often gigabytes of it. Without help, that history is a pile of raw files: a chat you lost stays lost, and an hour that went wrong stays a guess. The kit turns it into answers. Each row below is a real question from real work, answered by the kit:

You ask You run What came back
"I know we did this somewhere. Where?" ak sessions search "<a few words>" the lost chat, found across 2,386 projects in about a minute, and picked back up the same day
"Which chat changed this file, and why?" ak trace blame <file> every chat that changed it, each change, and the prompt that asked for it
"That felt slow. Where did the hour go?" ak sessions show <chat> one turn of 141 steps and 22 minutes, built in the wrong direction: the real waste, found
"Five chats touched this folder. What's mine?" ak trace blame <folder> 3 commits of this chat's own work; every other chat's changes left exactly as they were
"Is that chat still running, or waiting on me?" ak sessions live the chat thought lost: still open, waiting on an answer
"What does my helper agent really get?" ak xray claude -p "…" (with the gateway) a fix that quietly took a helper's Agent tool away, caught in a free dry run before anything ran
"Are my tests worth keeping?" /agentic-engineering:fewer-faster-tests a test skipped on every run since a rename, so a whole plugin was never checked
"What exactly does this page say?" nothing: Claude calls WebFetchRaw the page's own words in a file; Claude's WebFetch, asked for the same page verbatim, answered "I can't reproduce the full page verbatim"

Install

uvx --from "git+https://github.com/proxify-dev/agentic-kit#subdirectory=plugins/ak" ak setup

You need uv, git and Claude Code (claude on your PATH). Setup opens a picker in your terminal: it checks your machine, you tick what you want, it shows every change it will make, then installs.

Measured

The kit gives Claude three kinds of help:

Claude alone Claude with the kit
Find a chat, or the chat behind a file possible, slowly: it digs through gigabytes of raw files with grep and jq one command, from an index the tracer updates after every turn
See the exact prompt Claude or a helper sends the model not possible: chat files never keep the whole prompt as sent ak xray, a dry run: nothing sent, nothing billed (needs the gateway, off by default)
Check tests, skills, installs, the words of a rule whatever it remembers to check seven skills, each with the steps for one kind of check

The first one, raced on claude-sonnet-5-5 over 7 GB of real history, average of 2 runs:

"Which chat last changed gateway/README.md?" time steps cost
Claude alone 4m31s 17 $0.28
Claude + tracer 1m21s 5 $0.12
  • Same right answer, 3× faster. Over 12 runs on four questions: 2.4× faster overall.
  • The gain is in the finding. Once Claude has a chat's id, a quick fact about that one chat (its cost, its model) is just as fast without the kit, and that was the one question that tied.
  • Each answer cost cents, so what you get back is minutes and steps, not money.
  • The tracer sees changes made with Claude's Edit and Write tools, not by a shell command. Here it named the right chat but missed that chat's last edit, which was made with a shell command.

What you can pick

Setup always installs ak, the ak command the other pieces plug into. Type ak to see every verb you have.

tracer · your past sessions, searchable

Which session touched a file, and what each one did, read from Claude Code's own history files with no AI summary in between. Inside Claude Code, /tracer:trace <phrase> recaps a past session.

ak sessions              # this project's sessions, oldest first
ak trace blame <file>    # which sessions changed a file, and each change they made

agentic-engineering · skills for building with agents

Seven skills (context engineering, harness engineering, skill development, agent development, evals, sandboxing, fewer faster tests), an agentic-engineer agent, and a hook that gives Claude a short reminder at the moment a rule applies: before it edits a CLAUDE.md, briefs a subagent, or writes a skill or a hook.

/new-plugin <name>                          your own plugin: a folder tracked with git, loaded in every project
/new-skill · /new-agent                     a new skill or agent file, in your plugin by default
/agentic-engineering:harness-engineering    load one of the skills yourself

web · web pages, word for word

Claude's own WebFetch never gives it the page: a small model reads the page and Claude gets that model's answer, even when it asks for the exact text. web adds WebFetchRaw, a tool beside it: it saves the page itself to a file (the main content as markdown, or JSON, text and PDFs exactly as sent) and Claude reads that file. Claude picks it on its own when it needs exact words, code, numbers or links; WebFetch stays for questions about a page.

gateway · all your Claude accounts behind one claude

Off by default. Every model call goes through a small service on your machine; when one account runs out, the next one answers.

ak xray claude -p "hi"   # the exact prompt Claude would send: system prompt, tools, messages
claude --account <name>  # start on the account you name
ak gateway               # your accounts, and what went through the gateway
ak sysprompt             # your own instructions, added to every claude you start

ak xray is a dry run: the gateway answers the call itself, so the prompt is not sent and nothing is billed. The gateway comes with the claude shim: the claude you type becomes a small wrapper that adds your own instructions to every session (the real claude is not touched). Claude Code's own login is not used, so its banner says "API Usage Billing". Needs macOS, Linux or WSL, and Node 22.13 or newer.

What setup changes on your machine

  • the agentic-kit marketplace, added to Claude Code from GitHub with auto-update on: Claude Code keeps its own copy and brings you each new version, the same way it updates its official plugins
  • the plugins you picked
  • the ak command, as a uv tool in ~/.local/bin; it runs from Claude Code's copy, so it updates with the kit
  • with agentic-engineering or web: CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 in your Claude Code settings.json, which /new-plugin, /new-skill, /new-agent and WebFetchRaw need
  • only with the gateway: the claude shim on your PATH and a background service on 127.0.0.1:4747, both run from Claude Code's copy of this repo (nothing is downloaded besides it)

Every file it changes is backed up first.

ak setup --dry-run       # the plan and every change; writes nothing
ak setup status          # what is installed, and whether it works
ak setup undo            # take the last run back

Without setup

The tracer, agentic-engineering and web also install from inside Claude Code
/plugin marketplace add proxify-dev/agentic-kit
/plugin install tracer@agentic-kit                 needs uv
/plugin install agentic-engineering@agentic-kit    /new-* also need CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1
/plugin install web@agentic-kit                    needs uv and CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1

For updates, turn on auto-update once: /plugin → Marketplaces → agentic-kit → Enable auto-update.

Without ak, the tracer's command is tracer. It is on the PATH of Claude's Bash tool, not your terminal, so Claude runs tracer sessions and tracer trace blame <file> for you. Ask "which chat last changed src/app.py?", or type /tracer:blame src/app.py.

What is in this repo

plugins/ak/ the ak command and ak setup
plugins/tracer/ the session index and its skills
plugins/agentic-engineering/ the skills, the agent, the hooks
plugins/web/ WebFetchRaw: a web page's own content, saved to a file
gateway/ the gateway service; ak setup runs it from Claude Code's copy of this repo
shim/ the claude shim, installed the same way
.claude-plugin/marketplace.json the marketplace Claude Code reads

Tried end to end from GitHub on a fresh Linux machine. Not yet tried on Windows or on a fresh macOS account.

Use at your own risk

This is an independent project, not affiliated with or endorsed by Anthropic. It is provided as is (see LICENSE). You are responsible for using it within your agreements: Anthropic's terms for your accounts (the gateway can switch between several), and any client's rules about tools that read your Claude Code history or hold your credentials. Everything it records stays on your machine.

License

MIT © 2026 Constantin Teodorescu and Proxify.

About

No description, website, or topics provided.

Resources

Stars

4 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages