KAMI CLI Todo Manager

A lightweight and interactive CLI Todo Manager built with Go, featuring JSON persistence, REPL support, and automated CI/CD pipelines using GitHub Actions.

---

Preview

---

Features

• Interactive REPL mode with slash commands
• Full CRUD task management
• Persistent JSON-based storage
• Clean terminal table rendering
• Lightweight and minimal
• CI/CD integration with GitHub Actions

---

Tech Stack

• Go (Golang) - Core application development
• Go Modules - Dependency management
• aquasecurity/table - Terminal table rendering
• JSON (todos.json) - Persistent local storage
• GitHub Actions - CI/CD automation
• golangci-lint - Linting and static analysis

---

Installation

1. Clone the Repository

git clone https://github.com/Debashich/Kami.git
cd Kami

2. Install Dependencies

go mod tidy

3. Build the Binary

go build -o todo

---

Quick Start

1. Run the Application

./todo

Or directly with Go:

go run .

---

Interactive REPL Mode

Available Commands

Command	Description
/add Finish project	Add a new task
/list	Display all tasks
/toggle 0	Toggle task completion
/edit 0 Updated text	Edit a task
/del 0	Delete a task
/help	Show help menu
/exit	Exit the REPL

---

Flag Mode

Run commands directly using CLI flags.

Add a Task

./todo -add "Finish Go project"

List Tasks

./todo -list

Toggle Completion

./todo -toggle 0

Edit a Task

./todo -edit "0:Complete the Go CLI tutorial"

Delete a Task

./todo -del 0

Help

./todo -h

---

CI/CD Pipeline

GitHub Actions automatically handles:

• Builds
• Linting
• Testing
• Continuous Integration checks

---

Project Structure

.
├── .github/
│   └── workflows/
│       └── go.yaml
├── commands.go
├── main.go
├── storage.go
├── todo.go
├── todos.json
├── go.mod
├── go.sum
├── ui.go
└── README.md

---

License

Licensed under the MIT License.