Home
HalpTask is a high-performance, keyboard-driven Terminal User Interface (TUI) bullet outliner & task manager designed for speed, security, and developer productivity. Built in Go with Charm Bubble Tea & Lip Gloss, storing tasks in human-readable Markdown with optional AES-256-GCM encryption.
| Section | Description |
|---|---|
| 🚀 Getting Started | Installation, first launch, core concepts, and a 5-minute quickstart guide. |
| 👥 User Personas & Workflows | Tailored guides for Programmers, DevOps/SRE, Product Managers, Lawyers, and Knowledge Workers. |
| ⚡ Power User Guide | Master Vim motion combos, WhichKey leader hacks, subtree hoisting (ff), dynamic tag inheritance, and terminal shell integration. |
| ⚙️ Configuration & Security | Customizing config.yaml, using the Config Dashboard (<space> c c), theme switching, and AES-256-GCM encryption setup. |
| ⌨️ Keybindings Reference | Exhaustive, categorized cheatsheet for all Leader Key (<space>) sequences and Vim Normal Mode motions. |
| 🤖 Agent Wiki Maintenance Guidelines | Protocols for AI Coding Agents to keep documentation and Wiki pages synchronized with code updates. |
-
Vim Native Motion Engine: Seamless
j/k/h/l,gg/G,gi(jump to ID),oo/oc,dd,x,u,ctrl+r,tab/shift+tabtree editing. -
Permanent Task/Bullet Numbering: Each item has a persistent ID (
<!-- id: # -->). Instantly jump to any node withgior<space> g i. -
Leader Key & WhichKey System (
<space>): Non-intrusive popup menu guide that updates in real time as you type key sequences. -
Hierarchical Outliner & Folding: Collapse subtrees (
zc), expand (zo), toggle (za), or fold everything (zM/zR) with dynamic child counters. -
Task Management: Convert bullets into rich tasks with status cycling:
[ ]Todo ➔[~]In Progress ➔[x]Done. -
Focus Mode & Top Focus Banner 🎯: Mark any task/task group as your current focus (
fo/tf/<space> t f). Renders vivid🎯 FOCUSbadges, group focus indicators, and a persistent top Focus Banner with task context & attached note previews. -
Tag & Label System 🏷️: Assign direct tags (
T/<space> t a) with custom emojis & colors. Subtasks dynamically inherit parent tags ([↖🔥 urgent]). -
Compressed & Encrypted Task Archiving 📦: Archive completed tasks (
<space> a c) or selected subtrees (<space> a a) into schema-safe gzip-compressed storage (archive.dat) with interactive Archive Browser modal (<space> a v). -
Live Dashboard Panel (
<space> d): Real-time task statistics, completion progress bar ([████░░░░] 50%), and active in-progress task focus view. - AES-256-GCM Encryption: Secure sensitive task vaults with strong passphrase protection and zero plaintext memory leakage.
-
Plaintext Markdown Storage: Standard bullet and checkbox format (
~/.config/halptask/data.txt), compatible with standard text editors.
Important
Notice for AI Agents: When modifying features, keybindings, or configuration settings in HalpTask, always update this Wiki repository. See Agent Wiki Maintenance Guidelines for details.