# agented

A text editor for LLMs, not humans.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add frane/agented

# Browse available tools
npx -y smithery tool list frane/agented

# Get full schema for a tool
npx -y smithery tool get frane/agented ae_annotate_add

# Call a tool
npx -y smithery tool call frane/agented ae_annotate_add '{}'
```

## Tools (34)

- `ae_annotate_add` — Append an annotation.
- `ae_annotate_list` — List annotations.
- `ae_annotate_remove` — Soft-delete an annotation.
- `ae_annotate_search` — Search annotations across files.
- `ae_apply` — Run a batch of edit ops in one transaction. ops accepts JSON-lines / shortform / longform; first line of ops auto-detec…
- `ae_begin` — Open a transaction.
- `ae_branches` — List leaf edits.
- `ae_close` — Soft-close a file.
- `ae_commit` — Commit the open transaction.
- `ae_delete` — Delete lines [start,end].
- `ae_diff` — Unified diff between two edits.
- `ae_extract` — Cut lines [from_start,from_end] from path and write them to to_file (auto-created if absent). The canonical refactor pr…
- `ae_find` — Cross-file regex search across the workspace; returns per-file state tokens and a workspace state token.
- `ae_head` — Set head to a specific edit id.
- `ae_insert` — Insert text after a line (0 = start of file).
- `ae_list` — List registered files (uses default workspace unless workspace_path supplied).
- `ae_load` — Reload from disk; creates a branch if changed.
- `ae_log` — Audit log entries for a file.
- `ae_mark_add` — Add a mark anchored at a line.
- `ae_mark_get` — Get a mark.
- `ae_mark_list` — List marks on a file.
- `ae_mark_remove` — Remove a mark.
- `ae_merge` — Three-way merge between two leaf edits. Use prefer=a|b to auto-resolve every conflict in favor of one side; abort=true …
- `ae_move` — Atomically remove lines [from_start,from_end] and re-insert at to_line (same file when to_file is empty, otherwise cros…
- `ae_open` — Register a file in the workspace; returns annotations and state_token inline.
- `ae_redo` — Walk head pointer forward.
- `ae_replace` — Replace lines [start,end] (1-indexed inclusive) with provided text. Pass --expect from prior state_token.
- `ae_rollback` — Rollback the open transaction.
- `ae_save` — Write head content to disk.
- `ae_search` — Regex search; RE2 syntax.
- `ae_status` — Workspace or per-file status.
- `ae_undo` — Walk head pointer back.
- `ae_view` — Read file at head; returns numbered lines and state_token. Pass `ranges` for multi-range view (saves round trips).
- `ae_who` — Print current actor identity.

```bash
# Get full input/output schema for a tool
npx -y smithery tool get frane/agented <tool-name>
```

---

License: Apache-2.0