LazyArchon

A terminal-based task management TUI for Archon, inspired by lazygit/lazydocker

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

🎥 Demo

See LazyArchon in action:

✨ Features

• Two-Panel Interface: Task list on the left, detailed view on the right
• Task Management: View, edit status, manage features, and filter by features
• Vim-like Navigation: Use h/j/k/l keys for efficient browsing
• Rich Features:
  • Change task status with s (todo → doing → review → done)
  • Assign features to tasks with e
  • Filter by features with f (multi-select)
  • Search tasks with / and navigate with n/N
• Interactive Modals: Intuitive modal interfaces for task management
• Real-time Updates: Changes reflect immediately after editing
• Help System: Press ? for complete keyboard shortcuts
• Responsive Design: Handles terminal resize with automatic content reflow

🚀 Quick Install

Homebrew (recommended, macOS/Linux):

brew install yousfisaad/lazyarchon/lazyarchon

Go install (developers):

go install github.com/yousfisaad/lazyarchon/cmd/lazyarchon@latest

Direct download: Download from Latest Release, then:

tar -xzf lazyarchon-*.tar.gz
sudo mv lazyarchon /usr/local/bin/
lazyarchon --version

Build from source:

git clone https://github.com/yousfisaad/lazyarchon
cd lazyarchon && make build
./bin/lazyarchon

Prerequisites

• Running Archon API on localhost:8181
• Go 1.24+ (only for go install or build from source)

⌨️ Essential Keyboard Shortcuts

Key	Action
?	Show help (all shortcuts)
h/l	Switch panels (Tasks ↔ Details)
j/k	Navigate up/down (1 line)
J/K	Fast scroll (4 lines)
s	Change task status
e	Edit task features
f	Filter by features
/	Search tasks
n/N	Next/previous search result
p	Select project
r	Refresh data
q	Quit

For complete keyboard reference, see Key Bindings.

🚦 Current Status

What LazyArchon is good for:

• ✅ Browsing and exploring Archon tasks and projects
• ✅ Managing task status (todo/doing/review/done)
• ✅ Managing task features and filtering
• ✅ Reading task details in a clean terminal interface
• ✅ Navigating large task lists efficiently

Not yet available:

• ❌ Task creation and advanced editing
• ❌ Project management operations

📚 Documentation

• 📖 Full Documentation - Complete documentation index
• 🚀 Getting Started - Installation, configuration, quick start
• 👤 User Guide - Features, troubleshooting, advanced usage
• 🛠️ Development - Contributing, testing, build system
• ⚙️ Configuration - Customize API endpoint and preferences
• 🔧 Troubleshooting - Common issues and solutions

🛠️ Development

# Clone and setup
git clone https://github.com/yousfisaad/lazyarchon
cd lazyarchon

# Build and run
make build && ./bin/lazyarchon

# Or directly run from source
go run ./cmd/lazyarchon

# Run tests
make test

# See all available targets
make help

Built With

• Go 1.24+ - Programming language
• Bubble Tea - Terminal UI framework
• Lip Gloss - Terminal styling

🎯 Roadmap

• Task creation forms
• Advanced task editing (title, description, sources)
• Configuration files and themes
• Offline mode and caching

See Full Roadmap for more details.

🔗 Links

• Issues: GitHub Issues
• Discussions: GitHub Discussions

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Charm Bracelet - For the amazing Bubble Tea ecosystem
• Archon - For the task management platform
• lazygit/lazydocker - For UI/UX inspiration

---

Made with ❤️ and Go | Happy Task Managing! 🚀