oofind

Capability-bounded file finding utility for the openOODA era.

v0.1.0 100% openOODA Zero Ambient Authority JSON Streaming MCP Native

Install

Universal Standalone:

curl -fsSL https://openooda-tools.github.io/oofind/install.sh | bash

APT (Debian / Ubuntu):

curl -fsSL https://openooda-tools.github.io/oofind/install.sh | bash -s -- --apt

DNF (Fedora / RHEL / CentOS):

curl -fsSL https://openooda-tools.github.io/oofind/install.sh | bash -s -- --dnf

Zero dependencies. Standalone binary installs to /usr/local/bin (or ~/.local/bin). Native .deb and .rpm packages are also available directly on GitHub Releases.

Why not just find?

Feature	find	oofind
Implementation	C / gnulib	100% pure openOODA
Security model	ambient authority	capability-bounded (&FsReadCap)
Directory traversal	recursive readdir	recursive with symlink loop guard
Ignore rules	manual -prune	built-in `.gitignore` support
JSON Lines stream	no	yes (`--json`)
Null delimiter (`-print0`)	yes	yes
Agent surface	no	JSON-RPC 2.0 stdio MCP (`--mcp`)
Exit code contract	0 on success	standard POSIX or pipeline (`--exit-code`)

Try it

oofind . -name "*.oo"                     # Glob pattern matching
oofind src -type f -e txt                 # Filter regular files with extension
oofind . -maxdepth 2 -name "Makefile"     # Bounded depth traversal
oofind /var/log -type f -size +10M        # Size filtering
oofind src -name "*.oo" -print0 | xargs -0 wc -l  # Pipeline integration
oofind . -name "*.oo" --json              # JSON Lines output
oofind --mcp                              # Model Context Protocol stdio server

Source & docs · Releases · openOODA-tools