mirror of
https://github.com/awizemann/scarf.git
synced 2026-05-10 10:36:35 +00:00
Initial release: Scarf — macOS GUI for the Hermes AI agent
Native SwiftUI app providing full visibility into the Hermes AI agent: - Dashboard with system health, token usage, and cost tracking - Sessions browser with conversation detail and FTS5 search - Activity feed with tool call inspector (read/edit/execute/fetch/browser) - Embedded terminal chat via SwiftTerm with full ANSI/Rich rendering - Memory viewer/editor with live file-watching refresh - Skills browser by category with file content viewer - Cron job viewer with output display - Real-time log tailing with level filtering - Settings display with raw config and Finder path links - Menu bar status icon with quick actions Architecture: MVVM-Feature, zero dependencies beyond SwiftTerm, read-only SQLite access, Swift 6 strict concurrency. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,40 @@
|
||||
# Scarf — macOS GUI for the Hermes AI Agent
|
||||
|
||||
## Project Structure
|
||||
|
||||
```
|
||||
scarf/scarf/ Xcode project root (PBXFileSystemSynchronizedRootGroup — auto-discovers files)
|
||||
scarf/ Main app target source
|
||||
Core/Services/ HermesDataService, HermesFileService, HermesLogService, ACPClient, HermesFileWatcher
|
||||
Core/Models/ Plain structs: HermesSession, HermesMessage, HermesConfig, etc.
|
||||
Features/ MVVM-F feature modules (Dashboard, Sessions, Activity, Chat, Memory, Skills, Cron, Logs, Settings)
|
||||
Navigation/ AppCoordinator, SidebarView
|
||||
docs/ PRD, Architecture, Discovery notes
|
||||
standards/ Copied development standards (read-only reference)
|
||||
```
|
||||
|
||||
## Architecture Rules
|
||||
|
||||
- **MVVM-F**: Features never import sibling features. Cross-feature goes through services.
|
||||
- **AppCoordinator**: Single `@Observable` coordinator for all navigation state, injected via `.environment()`.
|
||||
- **No external dependencies**: System SQLite3, Foundation JSON, AttributedString markdown.
|
||||
- **Read-only DB access**: Never write to `~/.hermes/state.db`. Only write to memory files and cron jobs.
|
||||
- **Sandbox disabled**: App reads `~/.hermes/` directly.
|
||||
- **Swift 6 concurrency**: `@MainActor` default. Services use `nonisolated` + async/await.
|
||||
|
||||
## Key Paths
|
||||
|
||||
- Hermes home: `~/.hermes/`
|
||||
- SQLite DB: `~/.hermes/state.db` (WAL mode, read-only)
|
||||
- Config: `~/.hermes/config.yaml`
|
||||
- Memory: `~/.hermes/memories/MEMORY.md`, `~/.hermes/memories/USER.md`
|
||||
- Sessions: `~/.hermes/sessions/session_*.json`
|
||||
- Cron: `~/.hermes/cron/jobs.json`
|
||||
- Logs: `~/.hermes/logs/errors.log`, `~/.hermes/logs/gateway.log`
|
||||
- ACP: `hermes acp` subprocess (stdio JSON-RPC)
|
||||
|
||||
## Build
|
||||
|
||||
```bash
|
||||
xcodebuild -project scarf/scarf.xcodeproj -scheme scarf -configuration Debug build
|
||||
```
|
||||
Reference in New Issue
Block a user