aifed - AI-First Editor

A text editor designed for AI agents.

Core Philosophy

aifed's goal is to design a dedicated text editor for AI agents, implemented as a CLI, improving AI's editing efficiency, accuracy, and comfort.

• CLI is the best UI for AI - Text input/output, structured responses
• Progressive disclosure - Simple commands for simple tasks, advanced features on demand
• Decoupled from AI Agents - Any coding agent that supports shell can use it

Getting Started

See the Installation Guide for setup instructions.

Current Status

Core features are implemented and available for experimental use in real scenarios:

Feature	Status
read - Read file content with hashlines	Ready
edit - Edit file with hashline verification	Ready
lsp - LSP integration (Rust first)	Ready
history/undo/redo - Edit history and recovery	Ready
copy/paste/clipboard - Clipboard operations	Ready

Current focus: Optimizing the AI agent experience through real-world usage. Testing and refining the workflow in actual coding tasks.

Usage Examples

Note: The examples below illustrate the typical workflow. All core commands (read, edit, lsp, history/undo/redo) are implemented.

AI agents can obtain the full usage guide with:

aifed --skill

Here's how an AI agent might work with aifed in typical development scenarios:

Understanding Code

# Read line 15 of main.rs with hashlines for safe editing
aifed read main.rs 15

15:3K|let count = calculate_total(items);

# Get symbol locators on line 15 for LSP operations
aifed lsp symbols main.rs 15

15:3K|let count = calculate_total(items);
S1:count
S2:calculate_total
S3:items

# Get type info for calculate_total function
aifed lsp hover main.rs 15:3K S2:calculate_total

# Go to definition of items
aifed lsp def main.rs 15:3K S3:items

Refactoring

# Get symbol locators on line 10
aifed lsp symbols main.rs 10

10:AB|let config = load_config();
S1:config
S2:load_config

# Find all references to config
aifed lsp refs main.rs 10:AB S1:config

# Rename config to settings across the codebase
aifed lsp rename main.rs 10:AB S1:config settings

# Edit line 10 with hashline verification
aifed edit main.rs <<'EOF'
= 10:AB "let settings = load_config();"
EOF

Debugging

# Check for errors after changes
aifed lsp diag main.rs

History & Recovery

# View recent edit history
aifed history main.rs --count 5

# Undo if something went wrong
aifed undo main.rs

# Redo if you change your mind
aifed redo main.rs

Documentation

• CLI Reference - Command documentation
• CLI Design Notes - Design rationale and trade-offs

Credits

This project was inspired by:

• agent-browser - A browser designed for AI agents
• oh-my-pi - The Hashline Edit Mode inspired our Locator design

Contributing

See CONTRIBUTING.md for ways to contribute to the project.