local-work¶

Professional CLI toolkit for task and note management v3.2.2

Streamline your development workflow with organized tasks, daily notes, standup reports, and meeting logs—all from your terminal.

Quick Start¶

# Install globally
npm install -g local-work

# Initialize in your project
cd /path/to/your/project
task init

# Create your first task
task new "Implement user authentication" -p high

# Start working
task start TASK-001

# Take notes
note daily
note meeting "Sprint Planning"

Features¶

Task Management¶

• Auto-incrementing IDs - Sequential task numbering (TASK-001, TASK-002, ...)
• Status Workflow - backlog → active → completed → archived
• Priority System - low, medium, high with color coding
• Time Tracking - Estimated vs actual time with variance analysis
• Standup Reports - Generate daily/weekly standup reports (text, markdown, JSON)
• Full-text Search - Find tasks across all fields

Note Taking¶

• Daily Notes - One note per day with automatic dating
• Meeting Notes - Structured meeting logs with participants and action items
• Technical Decisions - Architecture Decision Records (ADRs)
• Learning Notes - Today I Learned (TIL) documentation

Project-Aware (v3.2.2)¶

• Git-like Model - Local workspace (.local-work/) or global workspace
• Auto-detection - Works from any subdirectory in your project
• Global Flag - Use -g or --global to access global workspace
• Zero Config - Works out of the box with sensible defaults

Agent Integration¶

• Provider Support - Claude, Copilot, Gemini, OpenAI
• Two Scopes - Global (home) or workspace (project)
• Local Templates - Uses markdown instructions and templates

Cross-Platform¶

• Linux - XDG Base Directory specification
• macOS - Standard ~/Library paths
• Windows - AppData directories

Requirements¶

• Node.js >= 18.18.0
• npm (included with Node.js)
• Supported platforms: Linux, macOS, Windows

Documentation Structure¶

Links¶

• GitHub Repository
• npm Package
• Blog Post
• Report Issues

Contributing¶

Contributions are welcome! See the Contributing Guide for details.

License¶

MIT License - see LICENSE for details.