Hello Dev Community I'm developing a tool called showsignature
I've been using it to develop itself since the beginning and I've use it on other projects tool, and just feels right.
It started as specific tool I needed for a particular problem at the beginning, but it was so useful that I adopted it entirely in my code environment with other project, and I took features and added others depending on the need.
I code mostly with Pi, but I've used Opencode, Codex and Claude code too, and is very useful there as well.
The tools if fully open-source, and I believe it may be useful to other people too, specially in this times where tokes are becoming more and more expensive each time, and code bases grow and grow, with features here and there.
It only has 4 dependencies commander, globby, typescript and zod.
Here is a benchmark for those wondering if this tool is really useful:
For me those results are very impressive because they represent a reduction on %60 token usage and increase in success rate for tasks.
showsignature map [OPTION]... [PATH]...
showsignature read [OPTION]... <FILE>
It has two commands:
map — structural overview: signatures and other extracted entries. Inspect [PATH] operands—files or directory paths—using the current directory by default.
read — literal windowed read of exactly one file, with an optional structural outline around the window for orientation.
Running showsignature with no command prints help and exits with code 1.
For Pi and Opencode it works as a native tool call, for Claude code and Codex is used as a bash command.
So if you want to give a try, I'm fully opened to critics, bug reports and pull requests, if you haven't contribute to opensource and need that for your resume, you're also welcome.
vibe-testing.1 is also welcome.
https://github.com/FredySandoval/showsignature
Vibe-testing: asking your agent to use a tool or command exhaustively until it find a strange behavior or bug and report. ↩