cosh-tools 0.1.4

Tools crate for cosh - coding agent for the terminal
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

# cosh-tools

[![Crates.io](https://img.shields.io/crates/v/cosh-tools.svg)](https://crates.io/crates/cosh-tools)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](https://github.com/DiegoZaluski/co-sh/blob/main/LICENSE)

Tools crate for [cosh](https://github.com/DiegoZaluski/co-sh) — a coding agent for the terminal.

`cosh-tools` implements every tool the cosh agent harness exposes to the LLM: filesystem operations, bash execution, search, LSP, web, desktop control, skills, subagents, planning, and structured user questions. Each tool is a self-contained async builder API plus an [MCP-schema](https://modelcontextprotocol.io/specification/2025-11-25/server/tools) tool description, so the crate can be used standalone in your own agent — the same tools the cosh app registers.

## Highlights

- **Sandboxed file editing** — reads carry a `file_hash` that writes must verify; edits are anchored on hashline tags with per-target errors, plus fuzzy-equivalent matching and AST-based structural rewrites (`ast-grep` + `tree-sitter`). Every write records a version for session rollback.
- **Path guarding** — all paths are denied until the project root is set; write and read-only allow/blocklists, and kernel-pinned sandboxing (`openat` + `O_NOFOLLOW`) on Unix.
- **Accessibility-tree-first computer tools** — observe and drive native desktop apps through the OS accessibility tree ([`xa11y`](https://crates.io/crates/xa11y)), with screenshots and synthetic input as support. Works on X11 and Wayland.
- **Streaming bash** — stdout/stderr streamed as chunks with exit codes, PTY mode, timeouts, and pre-spawn security validation.
- **ACP subagents** — dispatch to external agent harnesses (Gemini, Claude, Codex, Cline, Devin, Goose, OpenCode, Kilo) or an internal nested harness, with session resume and streamed turns.
- **LSP integration** — definitions, references, renames, call hierarchy and passive diagnostics feedback on touched files.
- **Skills system** — schema-driven `SKILL.md` capability packs with glob matching and sandboxed asset reads.
- **Vector recall** (optional, `embed` feature) — embedding-agnostic LanceDB similarity search.

## Tools

| Module | Tools |
|---|---|
| `fs` | `fs_read`, `fs_write`, `fs_edit`, `fs_edit_lines`, `fs_ast_edit`, `fs_rollback` |
| `bash` | `bash_run` |
| `find` | `find_glob`, `find_grep` |
| `lsp` | `lsp_definitions`, `lsp_references`, `lsp_symbols`, `lsp_rename`, `lsp_hover`, `lsp_code_actions`, … |
| `computer` | `computer_apps`, `computer_snapshot`, `computer_act`, `computer_control`, `computer_screenshot`, `computer_wait` |
| `web` | `web_fetch`, `web_search` |
| `skills` | `skills_list`, `skills_read`, `skills_read_asset`, `skills_match_skills` |
| `subagent` | `subagent_call` |
| `plan` | `plan_todo_write` |
| `question` | `ask_questions` |
| `recall` (`embed`) | `recall_search` |

## Usage

```rust
use cosh_tools::fs::{Fs, Target};

#[tokio::main]
async fn main() {
    let fs = Fs::new().cwd("/path/to/project");

    // Read a file — the result carries a file_hash and a hashline header.
    let results = fs
        .read(vec![Target {
            path: "src/main.rs".to_string(),
            line: None,
            symbol: None,
            line_range: None,
            offset: None,
            limit: None,
        }])
        .await;

    println!("file_hash: {}", results[0].file_hash);
    println!("{}", results[0].content);
}
```

More examples in [`examples/`](https://github.com/DiegoZaluski/co-sh/tree/main/crates/cosh-tools/examples) — run with `cargo run --example fs-read` (also `bash`, `computer-control`, …).

## Requirements

- Rust 2024 edition (≥ 1.85)
- The `computer` module needs an OS accessibility stack (X11 or Wayland)
- External agent CLIs only if dispatching to them via `subagent_call`

## Related crates

- [`cosh-sdk`](https://crates.io/crates/cosh-sdk) — agent harness SDK
- [`cosh-recall`](https://crates.io/crates/cosh-recall) — memory and context recall
- [`cosh-tui`](https://crates.io/crates/cosh-tui) — terminal interface

## License

Apache-2.0. See [LICENSE](https://github.com/DiegoZaluski/co-sh/blob/main/LICENSE).