Robokeys Logo Robokeys

Important Notice Regarding Robokeys Limited

Please note that as of March 2026, the commercial entity Robokeys Limited has been disolved.

The Software Lives On

This administrative change does not affect the availability or development of the open-source projects. Ownership and maintenance of the code repositories (including the Robokeys platform) have been transferred to Rob Deas, who will continue to lead development and support the community.

Commercial Enquiries

Commercial support and consulting remains available directly through Rob Deas. s.

Introducing Puzzlegrep

Grep for Structured Code Tags – Search AI-aware context across any codebase.

Explore on GitHub Read Blog Post

What is Puzzlegrep?

Puzzlegrep is a CLI tool for searching structured code annotations like RobokeyTags. It lets you grep for meaning—not just text—making both human and AI collaboration easier.

Why It Matters

Traditional grep finds words, not context. Puzzlegrep understands RobokeyTags—structured markers for code regions, notes, and AI hints—so you can filter by intent, authorship, or purpose.

Key Features

Filter by Marker

Search by 🧩 Puzzle (tool), 📌 Pin (human), or 🤖 Robot (AI) tags.

Tag-Type Filtering

Focus on specific tag types like Section, Note, or Region.

Structured Output

Export matches as text or JSON for CI/CD, scripts, or bots.

Language-Agnostic

Works on any source code file—because structure matters more than syntax.

Fast & Lightweight

Built with Bun for speed, no heavy dependencies required.

Example Usage

# Find all human notes puzzlegrep --pin --tag-type=Note "**/*" # Find AI suggestions as JSON puzzlegrep --robot --tag-type=Note "**/*" --json

Installation

# Clone and run with Bun git clone https://github.com/robokeys/robokeytags-tools.git cd tools/puzzlegrep bun puzzlegrep.js --help

Puzzlegrep is the first official tool for the RobokeyTags ecosystem, making structured, AI-aware code discoverable and usable in real workflows.

Download on GitHub Read Blog Post