ONI

Single-command context aggregation for LLMs, straight to your macOS clipboard.

CLI that makes a single context widow from your files and sends it directly to your macOS clipboard.

Key Features

• Direct to Clipboard: Uses macOS pbcopy under the hood to send your aggregated code context straight to your clipboard.
• Smart Filtering: Ignores binary files and junk directories (.git, node_modules, .venv, build caches) automatically.
• Syntax Awareness: Maps file extensions to Markdown code fences (py, ts, rs, go, sql, etc.) for LLM legibility.
• Interactive Prompting: If run with no arguments, Oni prompts for target glob patterns.
• Size Safeguards: Skips oversized source files with customizable thresholds.

Installation

Ensure you have Python 3.9+ installed:

Quick Usage

Parse everything in the current directory

oni

If called without patterns, Oni triggers an interactive prompt defaulting to **/*.

Parse specific directories or file globs

# Ingest entire src directory
oni src/**/*

# Combine specific file types
oni "src/**/*.py" "config/*.json"

# Ingest explicit targets
oni main.py pyproject.toml docs/README.md

CLI Options Reference

Usage: oni [OPTIONS] [PATTERNS]...

Examples with Flags

Omit Metadata Header

Generate pure code fence blocks with no introductory repository summaries:

oni "src/**/*.rs" --raw

Adjust Max File Size Threshold

Lower file size limit to 200 KB and inspect the payload before pasting:

oni "**/*.ts" --max-kb 200 --preview

Automatic Exclusions

Oni ignores the following paths during scanning:

.git          node_modules     __pycache__
.venv         venv             .pytest_cache
.mypy_cache   dist             build
.DS_Store     .idea            .vscode

Binary files are detected via null-byte inspection and excluded from the output buffer.