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
🤖 Agent Integration - Generate provider agents (Claude, Copilot, Gemini, OpenAI) from templates

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"

🤖 Agent Integration

Local-work can generate provider agents from Markdown templates for popular LLM clients.

# Setup agent (default provider: claude)
task agent setup

# Setup for a specific provider
task agent setup --provider claude

# List agent files
task agent list

# Validate agent file
task agent test --provider claude

Docs: Agent CLI Reference

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.