Rename project context file from .sofosrc to AGENTS.md; change screenshot

Author: alexylon

.sofosrc AGENTS.md.sofosrc renamed to AGENTS.md

@@ -26,7 +26,7 @@ Sofos is a terminal-based AI coding assistant powered by Anthropic's Claude API.
    - **Loop-based handling** allows Claude to use multiple tools in sequence iteratively
 
 3. **Two-Level Instructions** (src/session/history.rs)
-   - `.sofosrc`: Project-level, version controlled
+   - `AGENTS.md`: Project-level, version controlled
    - `.sofos/instructions.md`: Personal, gitignored
    - Both appended to system prompt at startup
 
@@ -101,11 +101,11 @@ src/
 - Supports both regular and server-side tools (like web_search)
 
 **src/ui/diff.rs**
-- Generate contextual diffs showing only changed code blocks
-- Uses `similar` crate for accurate line-by-line diffing
-- Formats output with colored backgrounds (red for deletions, blue for additions)
+- Generate contextual diffs with syntax highlighting and line numbers
+- Uses `similar` crate for diffing, `syntect` for syntax coloring
+- Dark backgrounds (#5e0000 deletions, #00005f additions) with syntax-colored code
 - Context lines (default: 2) show unchanged code around changes
-- Used by morph_edit_file tool to display what changed
+- Used by edit_file, write_file, and morph_edit_file tools
 
 **src/session/history.rs**
 - SessionMetadata: Preview and timestamps for session list
@@ -315,10 +315,10 @@ cargo test -- --nocapture     # Show println output
 
 ### Adding a New Tool
 
-1. Define tool in `src/tools/types.rs` (get_tools or get_tools_with_morph)
-2. Implement execution in appropriate file (filesystem.rs, bashexec.rs, etc)
-3. Add match arm in `src/tools/mod.rs` (ToolExecutor::execute)
-4. Test the new tool thoroughly
+1. Add variant to `src/tools/tool_name.rs` (ToolName enum, as_str, from_str)
+2. Define tool schema in `src/tools/types.rs` and add to tool lists
+3. Implement execution in `src/tools/mod.rs` (ToolExecutor::execute match arm)
+4. Add tests in `src/tools/tests.rs`
 5. Update README.md with tool description
 
 ### Modifying Bash Command Permissions
@@ -392,7 +392,7 @@ This prints:
 
 **Always:**
 - Test security features when making changes to filesystem or bash tools
-- Update both README.md and this .sofosrc when adding features
+- Update both README.md and this CLAUDE.md when adding features
 - Run `cargo test` before committing
 - Add helpful error messages for user-facing errors
 

CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to Sofos are documented in this file.
 
 ## [Unreleased]
 
+### Added
+- `edit_file` tool for targeted string replacement edits (no external API required)
+- `glob_files` tool for recursive file pattern matching (`**/*.rs`, `src/**/mod.rs`)
+- `web_fetch` tool for fetching URL content as readable text
+- Syntax highlighting inside diffs with line numbers
+- Streaming infrastructure for Anthropic SSE API (disabled pending incremental markdown rendering)
+
+### Changed
+- Renamed project instructions file from `.sofosrc` to `AGENTS.md` per the [AGENTS.md](https://agents.md) convention for providing project context to AI agents
+- Replaced yanked `pulldown-cmark-mdcat` with `pulldown-cmark` + custom ANSI markdown renderer
+- Improved diff display: darker backgrounds (#5e0000 / #00005f), syntax-colored code, line numbers
+- Tool output with ANSI formatting (diffs) no longer dimmed
+
 ## [0.1.20] - 2026-03-23
 
 ### Added

README.md

@@ -6,7 +6,7 @@ A blazingly fast, interactive AI coding assistant powered by Claude or GPT, impl
 
 Tested on macOS but should work on Linux and Windows as well.
 
-<div align="center"><img src="/assets/sofos_code.png" style="width: 800px;" alt="Sofos Code"></div>
+<div align="center"><img src="/assets/screenshot.png" style="width: 800px;" alt="Sofos Code"></div>
 
 ## Table of Contents
 
@@ -40,13 +40,16 @@ Tested on macOS but should work on Linux and Windows as well.
 - **Image Vision** - Analyze local or web images
 - **Session History** - Auto-save and resume conversations
 - **Custom Instructions** - Project and personal context files
-- **File Operations** - Read, write, list, create (sandboxed)
+- **File Operations** - Read, write, edit, list, create (sandboxed)
+- **Targeted Edits** - Diff-based `edit_file` for precise string replacements
 - **Ultra-Fast Editing** - Optional Morph Apply integration (10,500+ tokens/sec)
+- **File Search** - Find files by glob pattern (`**/*.rs`)
 - **Code Search** - Fast regex search with ripgrep
 - **Web Search** - Real-time info via Claude's/OpenAI's native search
+- **Web Fetch** - Read documentation and web pages
 - **Bash Execution** - Run tests and builds (read-only, sandboxed)
 - **MCP Integration** - Connect to external tools via Model Context Protocol
-- **Visual Diffs** - Colored change display
+- **Visual Diffs** - Syntax-highlighted diffs with line numbers
 - **Iterative Tools** - Up to 200 tool calls per request
 - **Context Compaction** - Summarizes older messages instead of dropping them
 - **Cost Tracking** - Session token usage and cost estimates
@@ -72,7 +75,7 @@ git clone https://github.com/alexylon/sofos-code.git
 cd sofos-code && cargo install --path .
 ```
 
-**Important:** Add `.sofos/` to `.gitignore` (contains session history and personal settings). Keep `.sofosrc` (team-wide instructions).
+**Important:** Add `.sofos/` to `.gitignore` (contains session history and personal settings). Keep `AGENTS.md` (team-wide instructions).
 
 ## Usage
 
@@ -157,9 +160,9 @@ For Claude, it enables the thinking protocol and `--thinking-budget` controls to
 For OpenAI (gpt-5 models), `/think on` sets high reasoning effort and `/think off` sets low reasoning effort. 
 The `--thinking-budget` parameter only applies to Claude models.
 
-## Custom Instructions
+## Custom Instructions/Context
 
-**`.sofosrc`** (project root, version controlled) - Team-wide conventions, architecture (see this project's `.sofosrc` for example)
+**[`AGENTS.md`](https://agents.md)** (project root, version controlled) - Project context for AI agents, team-wide conventions, architecture
 **`.sofos/instructions.md`** (gitignored) - Personal preferences
 
 Both loaded at startup and appended to system prompt.
@@ -173,13 +176,16 @@ Conversations auto-saved to `.sofos/sessions/`. Resume with `sofos -r` or `/resu
 **File Operations:**
 - `read_file` - Read file contents
 - `write_file` - Create or overwrite files
+- `edit_file` - Targeted string replacement edits (no API key needed)
 - `morph_edit_file` - Ultra-fast code editing (requires MORPH_API_KEY)
-- `list_directory` - List directory contents
+- `list_directory` - List a single directory's contents
+- `glob_files` - Find files recursively by glob pattern (`**/*.rs`, `src/**/test_*.py`)
 - `create_directory`, `delete_file`, `delete_directory`, `move_file`, `copy_file` - Standard file ops
 
 **Code & Search:**
 - `search_code` - Fast regex-based code search (requires `ripgrep`)
 - `web_search` - Real-time web information via Claude's/OpenAI's native search
+- `web_fetch` - Fetch URL content as readable text (documentation, APIs)
 - `execute_bash` - Run tests and build commands (read-only, sandboxed)
 
 **Image Vision:**
@@ -190,7 +196,7 @@ Conversations auto-saved to `.sofos/sessions/`. Resume with `sofos -r` or `/resu
 
 **Note:** Only `read_file`, `list_directory`, and `image` can access paths outside workspace when explicitly allowed in config. All other operations are workspace-only.
 
-Safe mode (`--safe-mode` or `/s`) restricts to: `list_directory`, `read_file`, `web_search`, `image`.
+Safe mode (`--safe-mode` or `/s`) restricts to: `list_directory`, `read_file`, `glob_files`, `web_search`, `web_fetch`, `image`.
 
 ## MCP Servers
 
@@ -334,7 +340,7 @@ src/
     └── builtin.rs       # Command implementations
 ```
 
-See `.sofosrc` for detailed conventions.
+See `AGENTS.md` for detailed conventions.
 
 ## Release
 

assets/screenshot.png

@@ -229,7 +229,7 @@ impl HistoryManager {
     }
 
     pub fn load_custom_instructions(&self) -> Result<Option<String>> {
-        let project_rc = self.workspace.join(".sofosrc");
+        let project_rc = self.workspace.join("AGENTS.md");
         let personal_instructions = self.workspace.join(".sofos/instructions.md");
 
         let mut combined = String::new();