LazyArchon v2.0 - Terminal TUI with Auto-Refresh for Archon Task Management

[yousfiSaad]

Hey Archon community! 👋

I'm excited to share LazyArchon v2.0, a terminal-based TUI (Text User Interface) for managing Archon projects and tasks. If you're a terminal enthusiast or spend most of your day in the command line, this might be a great addition to your workflow!

🎯 What is LazyArchon?

LazyArchon is a terminal user interface for Archon, inspired by tools like lazygit and lazydocker. It provides a fast, keyboard-driven way to browse tasks, manage status, filter by features, and more—all without leaving your terminal.

Built with Bubble Tea (Go's awesome TUI framework), it connects directly to your Archon API server and provides real-time updates via HTTP polling.

✨ Key Features

Task Management

• 📊 Two-Panel Interface: Task list (left) + Details panel (right)
• 🔄 Status Management: Change task status with interactive modals (todo → doing → review → done)
• 🏷️ Feature Management: Assign and manage task features/tags
• 🔍 Feature Filtering: Multi-select feature filtering with task counts
• 🔎 Enhanced Search: Inline search with real-time highlighting and vim-style n/N navigation

User Experience

• ⌨️ Vim-like Navigation: h/j/k/l for panel switching and scrolling
• 📜 Progressive Scrolling: j/k (precise), J/K (fast), Ctrl+u/d (half-page)
• 🎨 Clean UI: Markdown rendering for task descriptions with syntax highlighting
• 📋 Project Mode: Browse and filter tasks by project
• ❓ Built-in Help: Press ? for complete keyboard shortcuts
• 📐 Responsive: Real-time window resize handling

Data & Integration

• 🔌 API Connectivity: Connects to Archon API server (default: localhost:8181)
• 🔄 Auto-Refresh: Automatic data updates via HTTP polling (configurable interval, default 10s)
• ⚡ Manual Refresh: Press r to reload immediately
• 📦 Feature Discovery: Automatically discovers and filters by task features

🚀 Installation

Go Install

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

Build from Source

git clone https://github.com/yousfisaad/lazyarchon.git
cd lazyarchon
go build -o lazyarchon ./cmd/lazyarchon

📸 Quick Preview

LazyArchon - Project Name • 🔍 "api" (15)
┌─────────────────────────┐  ┌─────────────────────────────────┐
│ ○ Initialize project    │  │ # Task Title                    │
│ ◐ Implement API client  │  │                                 │
│ ◉ Add error handling    │  │ Detailed task description with  │
│ ● Create documentation  │  │ markdown formatting support.    │
│   [15 more tasks...]  ▓ │  │                               ░ │
│                       ░ │  │ **Status:** doing             ░ │
│                       ░ │  │ **Assignee:** AI IDE Agent   ▓ │
│                       ░ │  │ **Feature:** ui-navigation    ░ │
└─────────────────────────┘  └─────────────────────────────────┘
[Tasks] Connected • Match 2/3 • Sort: Status | /: search | n/N: next/prev match | Ctrl+L: clear search | ?: help

⌨️ Essential Keyboard Shortcuts

Key	Action
?	Show complete help
h/l	Switch between panels
j/k	Navigate up/down (1 line)
J/K	Fast scroll (4 lines)
t	Change task status
f	Filter by features
/	Search tasks
p	Select project
r	Refresh data
q	Quit

🎯 What LazyArchon Does Well

• ✅ Browsing tasks: Fast, keyboard-driven navigation through large task lists
• ✅ Managing status: Quick status changes with visual feedback
• ✅ Feature filtering: Multi-select filtering to focus on specific features
• ✅ Project overview: Get a quick overview of project status and task distribution
• ✅ Staying updated: Auto-refresh keeps data current without manual intervention

🚧 Current Limitations

LazyArchon is focused on browsing and managing existing tasks. These features are not yet implemented:

• ❌ Task Creation: Cannot create new tasks (coming soon!)
• ❌ Advanced Editing: Cannot modify task titles, descriptions, sources, or code examples
• ❌ Project Management: Cannot create or edit projects

🗺️ Roadmap

Next Release

• Task Creation Forms: Create new tasks with full form interface

Future Plans

• Advanced Task Editing: Full CRUD operations for tasks including titles, descriptions, sources, and code examples

🤝 Looking for Feedback!

I'd love to hear from the Archon community:

1. Would this fit into your workflow? Do you spend enough time in the terminal to make this useful?
2. Feature priorities? Which missing features would be most valuable to you?
3. Bug reports? Found any issues or have suggestions for improvements?
4. Integration ideas? Are there other Archon features that would work well in a TUI?

🔗 Links

• Website: https://lazyarchon.yousfisaad.com/
• Repository: https://github.com/yousfisaad/lazyarchon
• Documentation: Complete docs
• Issues: Report bugs or request features

🙏 Acknowledgments

Big thanks to:

• Charm Bracelet for the amazing Bubble Tea TUI framework
• Archon for the excellent task management platform and API
• lazygit/lazydocker for UI/UX inspiration

---

Made with ❤️ and Go | Happy task managing from the terminal! 🚀

Feel free to try it out and share your thoughts! I'm actively developing this and would love to make it better for the Archon community.