local-work

Professional CLI toolkit for task and note management. Streamline your development workflow with organized tasks, daily notes, and meeting logs—all from your terminal.

📚 Complete Documentation | 📝 Blog Post

Features

✨ Task Management - Auto-incrementing IDs, status workflow, priorities, time tracking 📋 Standup Reports - Generate daily/weekly standups in text, markdown, or JSON 📓 Note Taking - Daily notes, meeting logs, technical decisions, learning notes 🚀 Project-Aware - Works from any subdirectory, detects project root automatically 🔧 Zero Config - Works out of the box with sensible defaults 🌍 Cross-Platform - Linux, macOS, and Windows support

Quick Start

Installation

npm install -g local-work

Initialize Project

cd /path/to/your/project
task init

Create Your First Task

# Create a task
task new "Implement user authentication" -p high

# Start working
task start TASK-001

# Mark as done
task done TASK-001

# List tasks
task list

# Generate standup report
task standup

Take Notes

# Daily note
note daily

# Meeting note
note meeting "Sprint Planning"

# Technical decision
note tech "Migration to TypeScript"

Documentation

📚 Full Documentation

• Getting Started - Installation and setup
• Task Management - Complete task guide
• Note Taking - Note types and usage
• Configuration - Customization options
• Task CLI Reference - Task commands
• Note CLI Reference - Note commands
• Migration Guide - Upgrading from v2.x

Requirements

• Node.js ≥ 18.18.0
• Cross-platform: Linux, macOS, Windows

Contributing

Contributions welcome! Please read our contributing guidelines in the documentation.

# Fork and clone
git clone https://github.com/jonhvmp/local-work.git
cd local-work

# Install dependencies
npm install

# Run tests
npm test

# Link for local testing
npm link

License

MIT © Jonh Alex

Built for developers who value productivity and simplicity.