Skip to content

Latest commit

 

History

History
146 lines (104 loc) · 3.73 KB

README.md

File metadata and controls

146 lines (104 loc) · 3.73 KB

Was Doing (Work Documentation System)

A development-friendly work documentation system that helps you track what you're doing as you're doing it! 🚀

This project started almost completely generated by Cursor AI! using claude-3.5-sonnet-20241022, so take everything with a grain of salt while the code is validated by humans. 🐦 This canary clause will be removed when the code is fully validated.

🎯 New Here? Start Here!

Click here for our Friendly Onboarding Guide - We'll walk you through everything step by step!

Quick Start

# Install
mkdir -p ~/.local/bin
ln -s "$(pwd)/doc" ~/.local/bin/doc

# First time setup
doc --setup

# Start documenting
doc -n my-project        # Create a context
doc -H "Started work"    # Add history
doc -w                   # Watch mode

Command Reference

Setup & Configuration

doc --setup              # Run interactive setup
doc --verify            # Check configuration

Context Management

doc -c, --context NAME   # Switch to a context
doc -n, --new-context   # Create new context
doc -l, --list-contexts # List all contexts

Entry Management

doc -H, --add-history   # Add history entry
doc -s, --add-summary   # Add summary entry
doc --history          # View history entries
doc --summary          # View summary entries

Output Management

doc -w, --watch        # Watch mode: auto-regenerate
doc -r, --hot-reload   # Alias for --watch
doc -o, --output PATH  # Set output path
doc -e, --export PATH  # Export to PDF

Documentation

Our documentation is organized into several sections:

See our complete documentation index for more guides and technical details.

Project Structure 📁

was-doing/
├── 📄 __main__.py           # Entry Point & CLI
├── 📊 repository.py         # Data Layer
├── 📝 markdown_handler.py   # Document Generation
├── 👀 watcher.py           # File System Monitor
├── ⚙️ setup/               # Configuration
└── 📚 docs/                # Documentation
    └── wiki/              # Detailed guides

Contributing 🤝

We love contributions! Here's how you can help:

  1. Fork & Clone: Get your own copy to work on
  2. Branch: Create a feature branch
  3. Code: Make your changes
  4. Test: Ensure everything works
  5. Push & PR: Submit your contribution

All contributions are welcome:

  • 🐛 Bug fixes
  • ✨ New features
  • 📚 Documentation
  • 🎨 UI improvements
  • 🧪 Tests

Check out our Contributing Guide for details.

License 📜

This project is licensed under MIT + Commons Clause:

  • ✅ Free for personal use
  • ✅ Free for non-commercial projects
  • ✅ Modifications and improvements welcome
  • 🤝 Commercial use requires permission

See LICENSE for details.

For commercial use inquiries, please contact [email protected] or visit jknightdev.com.

Development