Open Source • MIT License

$ LazyArchon

|Terminal-based task management TUI for Archon

A powerful terminal user interface for managing Archon projects and tasks. Built with Bubble Tea, it provides vim-like navigation for efficient task management directly from your terminal.

Cross-platform
Open Source
Community Driven

Why Choose LazyArchon?

Built for developers who want to stay in the terminal and maintain their focus

Lightning Fast Navigation

Navigate between projects and tasks instantly with intuitive keyboard shortcuts. No mouse required.

h/l: panels • j/k: navigate • s: status • f: filter
🎯

Focused Workflow

Zero distractions. Clean, minimal interface that keeps you in the flow state.

No browser tabs • No notifications • Pure focus
🔧

Developer-First Design

Built by developers, for developers. Simple terminal interface that stays out of your way.

TUI interface • Fast performance • Lightweight binary
📊

Task Management

Comprehensive task status and feature management with intuitive modal interfaces.

Status changes • Feature assignment • Filtering
🎨

Clean Terminal Interface

Elegant TUI design with clear visual indicators and intuitive layout.

ASCII borders • Status indicators • Responsive layout
🚀

Cross-Platform

Works seamlessly on Linux, macOS, and Windows. Single binary, no dependencies.

Go binary • No runtime deps • Universal install

Get Started in Seconds

Install LazyArchon with a single command and start managing your projects like a pro

Installation Options

brew install yousfisaad/lazyarchon/lazyarchon
curl -sSL https://get.lazyarchon.dev | bash
go install github.com/yousfisaad/lazyarchon@latest
git clone https://github.com/yousfisaad/lazyarchon && cd lazyarchon && make build

Quick Start

  1. 1
    Install LazyArchon
    Choose your preferred installation method above
  2. 2
    Initialize your first project
    lazyarchon init
  3. 3
    Start managing projects
    lazyarchon
System Requirements
• Linux, macOS, or Windows
• Go 1.24+ (for building from source)
• Archon API server running on localhost:8181
• Terminal with colors support
• 10MB disk space

⚠️ Current Limitations

Task Creation: Cannot create new tasks (forms not yet implemented)
Advanced Task Editing: Cannot modify task titles, descriptions, or content
Real-time Updates: No WebSocket connection (manual refresh required)
Text Search: Only feature filtering available (no content search)

✅ What LazyArchon IS good for:

  • • Browsing and exploring Archon tasks and projects
  • • Managing task status (todo/doing/review/done)
  • • Managing task features and filtering
  • • Getting an overview of project status
  • • Efficient vim-like navigation

🚀 Roadmap

🔥 High Priority (Next Release)

  • Task Creation Forms: Create new tasks with full form interface
  • Configuration System: Config files for API endpoint and preferences
  • Debug Mode: Verbose logging and troubleshooting options

🚀 Medium Priority

  • Real-time Updates: WebSocket connection for live data
  • Text Search: Find tasks by content and title
  • Advanced Editing: Modify task content and descriptions

🌟 Long-term Vision

  • Plugin System: Extensible architecture
  • Offline Mode: Local caching and sync
  • Git Integration: Link tasks to commits