Skip to content
This repository was archived by the owner on Nov 21, 2025. It is now read-only.

Conversation

@scottsen
Copy link
Owner

Add progressive reveal CLI integration for efficient codebase exploration:

  • claude.md: Comprehensive project context and tool documentation
  • scripts/reveal.sh: Wrapper script for reveal CLI tool
  • scripts/README.md: Developer tools documentation

The reveal tool enables exploring files at 4 progressive levels:

  • Level 0: Metadata (size, type, line count)
  • Level 1: Structure (imports, classes, functions)
  • Level 2: Preview (representative sample)
  • Level 3: Full content (with paging)

Benefits:

  • Token conservation: Get 80% info at 20% token cost
  • Smart exploration: Understand structure before reading full files
  • Type-aware analysis: Python AST, YAML structure, JSON depth, etc.
  • Grep filtering: Find patterns across all levels

Source: https://gist.github.com/scottsen/ee3fff354a79032f1c6d9d46991c8400

Add progressive reveal CLI integration for efficient codebase exploration:
- claude.md: Comprehensive project context and tool documentation
- scripts/reveal.sh: Wrapper script for reveal CLI tool
- scripts/README.md: Developer tools documentation

The reveal tool enables exploring files at 4 progressive levels:
- Level 0: Metadata (size, type, line count)
- Level 1: Structure (imports, classes, functions)
- Level 2: Preview (representative sample)
- Level 3: Full content (with paging)

Benefits:
- Token conservation: Get 80% info at 20% token cost
- Smart exploration: Understand structure before reading full files
- Type-aware analysis: Python AST, YAML structure, JSON depth, etc.
- Grep filtering: Find patterns across all levels

Source: https://gist.github.com/scottsen/ee3fff354a79032f1c6d9d46991c8400
@scottsen scottsen merged commit 9f2e21a into master Nov 21, 2025
2 of 27 checks passed
@scottsen scottsen deleted the claude/document-tools-capabilities-01FMGmWoo35SWwRuXmLvKA63 branch November 21, 2025 19:04
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants