⚡ Zap TCM

Zap TCM (Zap Todo Control Manager) is a blazing-fast, Git-inspired CLI tool for managing todos like code.
Create branches for different projects, switch between them, and keep your workflow lightning clean ⚡

🚀 Features

• 🧠 Git-like workflow — Use familiar commands like zap add, zap branch, zap switch etc.
• 🗂️ Branch-based todo lists — Each branch acts as a separate todo list
• 💾 Persistent storage — Todos are locally stored across sessions in .zap repository
• 🔥 Minimal & intuitive — No setup needed, just start zapping tasks

🧩 Example Usage

# Initialize zap in your project
zap init

# Add a new todo
zap add "Finish the README file"

# List all todos
zap list

# Mark a todo as done
zap complete 1

# Create a new branch (todo list)
zap branch work

# Switch to another branch
zap switch work

# View branches
zap branch

⚙️ Installation

Using npm (recommended)

npm install -g zap-tcm

From source

git clone https://github.com/calebephrem/zap-tcm.git
cd zap
npm install
npm link

📚 Command Reference

• zap [command] — for current project (directory) (./.zap)
• zapg [command] — for global task management in home directory (~/.zap)

| Command | Description | | -------------------------------------- | ---------------------------------------------------------------------------------------------- | | init | Initialize a new zap repository | | branch [name] | Create a branch (or list branches if no name is given) | | branch [-d, --delete] [name] | Delete a branch | | branch [-r, --rename] [name] [newName] | Rename a branch | | switch [name] | Switch to a branch | | add [task] | Add a new task to the current branch | | list | List all tasks in the current branch | | update [id] [task] | Update a task | | remove [id] | Remove a task | | complete [id] | Mark a task as complete | | incomplete [id] | Mark a task as incomplete | | search [keyword] | Search tasks in the current branch (use search -g [keyword] to search globally) | | merge [source] [target] [--unsort] | Merge source branch into target branch (unsort based on createdAt if --unsort flag provided) | | tag [id] [tag] | Add a tag to a task (replace id with -d to remove a tag) | | tag [-r, --rename] [tag] [newTag] | Rename tag | | move [id] [branch] | Move a task to another branch | | import [branch] [file] | Import tasks from a file into a branch | | export [branch] [file] | Export tasks from a branch to a file | | stats | Show statistics for the current branch (use stats -g for global stats) | | config [scope] [key] [value] | Configuration for --global and --local settings | | config [key] | Get configuration value | | -v, --version | Show version information | | -h, --help | Show help message |

💡 Example Workflow

zap init
zap add "Build Quantum Theme site"
zap add "Complete the README file"
zap list

zap branch personal
zap switch personal
zap add "Learn Python"
zap add "Learn Rust"

zap switch main
zap list
zap complete 1

Each branch has its own independent todos — just like code branches in Git.

🧑‍💻 Contributing

Contributions are welcome!
Fork the repo, make your changes, and submit a pull request.
Make sure to read CONTRIBUTING before you start.

📄 License

MIT © Caleb Ephrem