テキストだけでなく、コンテキストのために grep。

ctxgrep は、ドキュメント、ノート、思い出、プロジェクトコンテキストを検索するためのローカルファースト CLI です。 人間とAIエージェントが正しいコンテキストを現在のタスクに引き出すのに役立つ、正確な検索、正規表現、意味のある検索、およびメモリ抽出を組み合わせます。

クイックセットアップ — ctxgrep のエージェントに指示

下のブロックをコピーし、Claudeコード、Cursor、Windsurf、または同様のエージェントハーネスに貼り付けます。 ctxgrep をインストールします。, スキルの参照を読みます, すべての将来のコンテキスト検索タスクに使用する方法を知っている.

必要なAPIキーなし — ctxgrep は、ローカルの組み込みモデルで、最初の実行時に自動ダウンロードする。

##特徴

• grep-like CLI* — コマンドラインインターフェイス
• ローカル優先インデックス — SQLite + FTS5、必要なサーバーなし
• ハイブリッド検索モード — 正確/正規表現/意味/ハイブリッド検索モード
• メモリー抽出 — 決定、設定、テキストからの制約を自動的に抽出
• Context パッキング — エージェントのトークン結合されたコンテキストバンドルを組み立てる -JSON出力 — 自動化およびAIエージェントの構成された出力 -Incremental indexing — 変更されたファイルとアップデートを監視

ctxgrep

grep for context, not just text.

ctxgrep is a local-first CLI for searching documents, notes, memories, and project context. It combines exact search, regex, semantic retrieval, and memory extraction to help humans and AI agents pull the right context into the current task.

Quick setup — tell your agent about ctxgrep

Copy the block below and paste it into your Claude Code, Cursor, Windsurf, or similar agent harness. It will install ctxgrep, read the skill reference, and know how to use it for all future context retrieval tasks.

I want you to use ctxgrep for local semantic search, hybrid retrieval, and
memory extraction across my documents and notes. Please do the following:

1. Install ctxgrep (if not already installed):
   curl -fsSL https://raw.githubusercontent.com/yetone/ctxgrep/main/install.sh | bash

   Or from source:
   cargo install --git https://github.com/yetone/ctxgrep

2. Read the ctxgrep skill reference so you know every command, flag, and
   workflow pattern:
   https://raw.githubusercontent.com/yetone/ctxgrep/main/skills/ctxgrep/SKILL.md

From now on, when you need to search documents, recall past decisions, or
assemble context for a task, use ctxgrep instead of manually grepping files.
For example:
  ctxgrep search --json "authentication design"
  ctxgrep memory --json --type decision "database schema"
  ctxgrep pack --json --budget 5000 "prepare context for the auth refactor"

No API key needed — ctxgrep ships with a local embedding model that auto-downloads on first run.

Features

• grep-like CLI — familiar command-line interface
• Local-first indexing — SQLite + FTS5, no server needed
• Hybrid retrieval — exact / regex / semantic / hybrid search modes
• Memory extraction — automatically extracts decisions, preferences, constraints from text
• Context packing — assembles a token-budgeted context bundle for agents
• JSON output — structured output for automation and AI agents
• Incremental indexing — watches files and updates only what changed
• Provenance — every result includes file path, line numbers, score, and why it matched

Installation

From binary releases

curl -fsSL https://raw.githubusercontent.com/yetone/ctxgrep/main/install.sh | bash

From source

cargo install --git https://github.com/yetone/ctxgrep

Build from source

git clone https://github.com/yetone/ctxgrep
cd ctxgrep
cargo build --release
# Binary at target/release/ctxgrep

Quick Start

# Index your documents
ctxgrep index ~/notes ~/docs ~/meetings --recursive

# Search in the current directory (default — like grep, scoped to CWD)
ctxgrep search "product positioning history"

# Search in specific directories
ctxgrep search "product positioning history" ~/notes ~/docs

# Search the entire index regardless of location
ctxgrep search --global "product positioning history"

# Exact search
ctxgrep search --exact "Lossless Feedback Loop"