Files
+16 2e5b5e7b23 Promote main → release (#5203)
Co-authored-by: YellowSnnowmann <167776381+YellowSnnowmann@users.noreply.github.com>
Co-authored-by: Steven Enamakel <31011319+senamakel@users.noreply.github.com>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: Cyrus Gray <144336577+graycyrus@users.noreply.github.com>
Co-authored-by: Horst1993 <horst.w@gmicloud.ai>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: James Gentes <jgentes@users.noreply.github.com>
Co-authored-by: Sam <samrusani@users.noreply.github.com>
Co-authored-by: Sami Rusani <14844597+samrusani@users.noreply.github.com>
Co-authored-by: oxoxDev <164490987+oxoxDev@users.noreply.github.com>
Co-authored-by: Muhammad Ismail <78064250+myi1@users.noreply.github.com>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Co-authored-by: nb213 <binyangzhu000@gmail.com>
Co-authored-by: binyangzhu000-sudo <224954946+binyangzhu000-sudo@users.noreply.github.com>
Co-authored-by: Steven Enamakel <enamakel@tinyhumans.ai>
Co-authored-by: CodeGhost21 <164498022+CodeGhost21@users.noreply.github.com>
Co-authored-by: sanil-23 <sanil@tinyhumans.ai>
Co-authored-by: M3gA-Mind <elvin@mahadao.com>
Co-authored-by: oxoxDev <oxoxdev@users.noreply.github.com>
Co-authored-by: mysma-9403 <64923976+mysma-9403@users.noreply.github.com>
Co-authored-by: mwakidenis <mwakidenice@gmail.com>
Co-authored-by: NgoQuocViet2001 <123613986+NgoQuocViet2001@users.noreply.github.com>
Co-authored-by: viet.ngo <viet.ngo@sotatek.com>
Co-authored-by: Maciej Myszkiewicz <mmyszkiewicz@bwcoders.com>
2026-07-27 11:49:45 +05:30

44 lines
2.4 KiB
Markdown

---
description: A complete toolset for working on real codebases - read, write, edit, search, git, lint, test.
icon: code
---
# Coder
The coder family is what makes OpenHuman a viable coding partner instead of a chat window that *pretends* to know the codebase.
## Tools in the family
| Tool | What it does |
| ---------------- | ----------------------------------------------------------------- |
| `file_read` | Read a file (with line numbers, like `cat -n`). |
| `file_write` | Write a new file. |
| `edit_file` | Targeted edits - match-and-replace with strict uniqueness checks. |
| `apply_patch` | Apply a unified diff. |
| `glob_search` | Find files by glob pattern. |
| `grep` | Ripgrep-style search across the tree. |
| `list_files` | Walk a directory tree. |
| `read_diff` | Diff between two files or revisions. |
| `git_operations` | Status, diff, log, blame, branch, commit. |
| `run_linter` | Run the project's linter. |
| `run_tests` | Run the project's test command. |
| `csv_export` | Export query results as CSV. |
## Why these are native, not shell-only
A shell tool plus `cat`/`sed`/`awk` could *technically* do all of this. The native tools exist because:
* Edits go through a uniqueness check, so the agent can't accidentally clobber the wrong line.
* Reads come back with line numbers the agent can refer to in follow-ups.
* Git operations parse output into structured data, instead of leaving the agent to scrape porcelain.
* Lint and test runs are wired to the project's actual commands, not generic guesses.
## Workspace scoping
Filesystem tools respect a workspace boundary - the agent can't read or write outside it without explicit permission. Same boundary the rest of the app uses for `OPENHUMAN_WORKSPACE`.
## See also
* [System & Utilities](system-and-utilities.md) - `shell`, `node_exec`, `npm_exec`, `python_exec` for the rest of the dev loop.
* [Agent Coordination](agent-coordination.md) - `todo_write`, `spawn_subagent` for larger refactors.