Local File and Code Search

What it does

When your agent uses it

• Finding where a function or symbol is defined in a local project
• Locating a file when you only remember part of its name
• Searching notes or documents on disk for a phrase
• Checking who last changed a line with git blame

Example prompts

• “Search ~/notes for every mention of the budget review and count the hits per file.”
• “Find code in this repo that swallows exceptions with a bare except.”
• “Show who last changed the retry logic in client.py and what else touched it recently.”

Requirements

• Python 3, to run scripts/seek.py
• ripgrep and fd installed locally

Workflow steps

10 steps, taken from the first numbered list in SKILL.md.

1. 1先窄后宽：先限定目录/扩展名，搜不到再扩大。禁止一开始就全盘扫。
2. 2先数后看：--count 看分布，--context 0（默认）看命中行，最后才读文件。
3. 3指定类型：代码场景加 --type（py,ts,go…），文档场景用 --scope doc。
4. 4绝对路径优先：涉及读文件时用 read_file + 绝对路径。
5. 5不读整个文件：L3 精读用行号偏移局部读取，命中上下文不够再扩。
6. 6结果为空先换词：换同义词/拆词/去大小写，再换工具（fd→mdfind），
7. 7中文搜索：rg 原生支持 UTF-8，直接搜中文；长中文词会自动放宽匹配，
8. 8先结构后正文：大文件先 --outline 看结构，再 --lines N-M 按需读取，
9. 9结构搜索按语义：找「是不是有裸 except」这类问题用 --structural，
10. 10git 只读标题：--git-log 只给标题，够用就停；要看具体改动再手动 git show，

What it can do on your machine

Read from SKILL.md and the folder at commit a6657b0. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 2 files in scripts/ (Python), which the agent can run.

  Shell commands in SKILL.md call:

  • python3

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Local File and Code Search loads about 1.1k tokens when it runs, and up to ~4.2k if it reads all its reference files. Until then it costs about 34 tokens; SKILL.md has 196 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~34

When it runs · the whole SKILL.md, loaded when a task matches

~1.1k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~4.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from taxueseek/argo at commit a6657b0, republished under its MIT licence (© taxueseek). 196 words, ~1,050 tokens.

name

local-seek

description

本机文件与代码内容搜索（rg/fd/mdfind/grep 统一入口 seek.py，工具输出即答案）。与 argo 联网搜索互补：搜本机目录、代码符号、文件名、文档全文、文件结构。触发：搜本地、找文件、找代码、本机搜 xx、代码在哪、统计本地命中。

version

1.4.1

# 以下以 argo 安装根为 cwd；或写死 $ARGO_HOME/sub-skills/local-seek/scripts/seek.py
python3 sub-skills/local-seek/scripts/seek.py "查询词"                 # 默认：当前目录全文
python3 sub-skills/local-seek/scripts/seek.py "查询词" --path ~/notes   # 指定目录
python3 sub-skills/local-seek/scripts/seek.py "词" --path ~/.agents --dot  # 连以 . 开头的目录和软链一起搜；搜 ~/.agents、~/.zcode 时要加（Spotlight 收不到这类目录，--dot 对 --spotlight 没用）
python3 sub-skills/local-seek/scripts/seek.py "词" --path . --include-noise  # repos/、tests/、tmp/、日期归档目录与真源平权（默认这些排在真源之后，但**仍然搜得到**）
python3 sub-skills/local-seek/scripts/seek.py "查询词" --count          # 先数命中，再决定是否深入
python3 sub-skills/local-seek/scripts/seek.py "查询词" --filename       # 按文件名
python3 sub-skills/local-seek/scripts/seek.py "查询词" --spotlight      # 全盘兜底（PDF/邮件/笔记）
python3 sub-skills/local-seek/scripts/seek.py "查询词" --type py,ts
python3 sub-skills/local-seek/scripts/seek.py "查询词" --json           # 结构化输出
python3 sub-skills/local-seek/scripts/seek.py "查询词" --exact          # 关闭中文扩展，精确匹配
python3 sub-skills/local-seek/scripts/seek.py "查询词" --exclude 某文件 # 额外排除（可重复）
python3 sub-skills/local-seek/scripts/seek.py --outline 文件路径        # 文件结构（def/class/标题/顶层key）
python3 sub-skills/local-seek/scripts/seek.py --lines 10-50 文件路径    # 按行读取，替代 read_file 全文
python3 sub-skills/local-seek/scripts/seek.py "裸except" --structural   # 结构搜索（空catch/裸except/装饰函数等）
python3 sub-skills/local-seek/scripts/seek.py --git-log 文件路径        # 文件的最近提交历史
python3 sub-skills/local-seek/scripts/seek.py --git-blame 12 文件路径   # 第 12 行的提交归属

© taxueseek, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 16 other files (scripts, references) in sub-skills/local-seek of taxueseek/argo.

• SKILL.md
• config/domains.yaml
• references/fd-mdfind-recipes.md
• references/git-integration.md
• references/remote-handoff.md
• references/rg-recipes.md
• references/strategies.md
• references/structural-search.md
• scripts/eval_seek.py
• scripts/seek.py
• tests/test_determinism_20261006.py
• tests/test_noise_tier.py
• tests/test_pcre2_probe.py
• tests/test_rank_pinyin.py
• tests/test_regression_20261003.py
• tests/test_regression_20261006.py
• tests/test_seek_degradation.py

Open the folder on GitHubat commit a6657b0