Skip to content

feat(codebase-tools): add codebase exploration and file search tools#3

Merged
jeancsil merged 1 commit intomainfrom
dev-agent
Feb 15, 2026
Merged

feat(codebase-tools): add codebase exploration and file search tools#3
jeancsil merged 1 commit intomainfrom
dev-agent

Conversation

@jeancsil
Copy link
Owner

Introduce a CodebaseExplorer base class and three explorer tools
to let agents discover and inspect project source code.

  • Add CodebaseExplorer with configurable root and ignore patterns to
    reduce noise (git, pycache, node_modules, venv, build, etc.).
  • Add StructureExplorerTool exposing discover_structure to recursively
    list directories and files with depth control and file sizes.
  • Add FileOutlinerTool exposing get_file_outline to extract class
    and function signatures from Python files for quick skimming.
  • Add FileFragmentReaderTool exposing read_file_fragment to read a
    specific line range using "path:start:end" input format.
  • Add initial code_searcher module scaffold for future search tools.

These changes provide foundational utilities for agentic tools to
navigate and inspect codebases programmatically, improving agent
context awareness and debugging capabilities.

Introduce a CodebaseExplorer base class and three explorer tools
to let agents discover and inspect project source code.

- Add CodebaseExplorer with configurable root and ignore patterns to
  reduce noise (git, __pycache__, node_modules, venv, build, etc.).
- Add StructureExplorerTool exposing discover_structure to recursively
  list directories and files with depth control and file sizes.
- Add FileOutlinerTool exposing get_file_outline to extract class
  and function signatures from Python files for quick skimming.
- Add FileFragmentReaderTool exposing read_file_fragment to read a
  specific line range using "path:start:end" input format.
- Add initial code_searcher module scaffold for future search tools.

These changes provide foundational utilities for agentic tools to
navigate and inspect codebases programmatically, improving agent
context awareness and debugging capabilities.
@jeancsil jeancsil self-assigned this Feb 15, 2026
@jeancsil jeancsil added the enhancement New feature or request label Feb 15, 2026
@jeancsil jeancsil merged commit d185656 into main Feb 15, 2026
3 checks passed
@jeancsil jeancsil deleted the dev-agent branch February 17, 2026 20:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant