How madhavan347/project_alfred works
Alfred is a local workflow orchestrator for configured tasks, command-line agents, Git worktrees, and human review. Operators configure a workspace, create and assign tasks, dispatch or queue runs, observe progress, then review completion reports and merge or archive work. Its CLI and web UI share composed application services; JSON state, Git, tmux, optional Markdown tracking, and knowledge support the lifecycle. The README documents these capabilities; several service implementations and UI routes were not sampled, so their internal links are omitted.
Main entry points: bootstrap.py Service composition · tasks.py Task management · dispatch.py Agent dispatch · worktrees.py Git worktrees
Components 22
Operator interfaces
- Alfred CLI
src/alfred/cli/main.py - Web API
ui/src/alfred_ui/app.py - Web interface
ui/web/src/App.vue - UI read model
ui/src/alfred_ui/snapshot.py - UI operations
ui/src/alfred_ui/actions.py
Task and run workflows
- Task management
src/alfred/application/tasks.py - Task lifecycle model
src/alfred/domain/models.py - Run dispatch
src/alfred/application/runs.py - Agent dispatch
src/alfred/application/dispatch.py
Execution and integrations
- Git worktrees
src/alfred/adapters/git/worktrees.py - Git commits
src/alfred/adapters/git/commits.py - Agent sessions
src/alfred/adapters/tmux.py - Process runner
src/alfred/adapters/process.py
Configuration and state
- Workspace config
src/alfred/config/loader.py - Service composition
src/alfred/bootstrap.py - JSON state store
src/alfred/adapters/state/json_store.py
Review and support
- Completion coordinator
src/alfred/application/coordinator.py - Human notifications
src/alfred/application/notifications.py - Project knowledge
src/alfred/application/knowledge.py - Knowledge learner
src/alfred/application/learner.py - Markdown tracker sync
src/alfred/application/sync.py
Other components
- Operator
Connections 30
- Operator → Alfred CLI: runs commands
- Operator → Web interface: uses interface
- Alfred CLI → Workspace config: initializes workspace
src/alfred/cli/main.py - Alfred CLI → Service composition: builds services
src/alfred/cli/main.py - Service composition → Workspace config: loads
src/alfred/bootstrap.py - Service composition → Task management: composes
src/alfred/bootstrap.py - Service composition → Run dispatch: composes
src/alfred/bootstrap.py - Service composition → Agent dispatch: composes
src/alfred/bootstrap.py - Service composition → Git worktrees: composes
src/alfred/bootstrap.py - Service composition → Git commits: composes
src/alfred/bootstrap.py - Service composition → Agent sessions: composes
src/alfred/bootstrap.py - Service composition → Process runner: composes
src/alfred/bootstrap.py - Service composition → JSON state store: initializes
src/alfred/bootstrap.py - Task management → JSON state store: persists tasks
src/alfred/application/tasks.py - Task management → Task lifecycle model: validates lifecycle
src/alfred/application/tasks.py - Run dispatch → Agent dispatch: dispatches runs
- Agent dispatch → Agent sessions: starts sessions
- Agent dispatch → Git worktrees: uses worktrees
- Git worktrees → Process runner: runs Git commands
src/alfred/adapters/git/worktrees.py - Git commits → Git worktrees: operates on
src/alfred/bootstrap.py - Agent sessions → Process runner: runs tmux commands
src/alfred/adapters/tmux.py - Web API → UI operations: routes operations
ui/src/alfred_ui/app.py - Web API → UI read model: serves read model
ui/src/alfred_ui/app.py - Web interface → Web API: requests data
- UI operations → Service composition: uses services
ui/src/alfred_ui/actions.py - UI read model → JSON state store: reads persisted state
ui/src/alfred_ui/snapshot.py - UI read model → Agent sessions: joins live sessions
- Completion coordinator → Human notifications: processes completions
- Knowledge learner → Project knowledge: records learnings
- Markdown tracker sync → Task management: reconciles tasks