Origin Workflow

A control-plane repository for automation, prompts, configurations, and CI that integrates with Origin Byte to manage personal workflows, knowledge capture, and creative exploration.

Master Design Goals

• Automate capture, triage, planner: Streamlined workflow for capturing ideas, triaging tasks, and planning execution
• Integrate random exploration and creative life: Balance structured productivity with creative discovery
• Produce artifacts to Origin Byte: Generate high-quality outputs for the main knowledge repository

Quickstart

Interactive CLI (Recommended)

The easiest way to use Origin Workflow is through the interactive CLI:

# Install the CLI
cd cli
npm install
npm link

# Start your day
origin-workflow daily

# Capture content
origin-workflow capture

# Check system health
origin-workflow health

See the CLI Quick Start Guide for more details.

Manual Setup

1. Clone this repository
2. Run ./scripts/bootstrap.sh to initialize the environment
3. Configure your schedule in configs/schedule.yaml
4. Set up your areas of focus in configs/areas.yaml
5. Start capturing ideas and information (see Capture Layer below)
6. Use the daily and weekly prompts in prompts/

Repository Structure

origin-workflow/
├── README.md                 # This file
├── .gitignore               # Git ignore patterns
├── LICENSE                  # MIT license
├── inbox.md                 # Primary capture destination
├── manifest.json            # Repository manifest
├── prompts/                 # Prompt templates and specifications
├── configs/                 # Configuration files (YAML)
├── workflows/               # Workflow definitions and automation
├── automation/              # Scripts and automation tools
├── scripts/                 # Utility scripts
├── data/                    # Data storage (captures.json)
├── docs/                    # Documentation
└── tests/                   # Tests and validation

Capture Layer

The capture layer provides multiple methods for quickly collecting ideas, links, and information into your workflow.

CLI Capture

Quick capture from the command line:

# Basic capture
node scripts/capture.js --title "Interesting article about productivity"

# With URL and tags
node scripts/capture.js --title "AI productivity tools" --url "https://example.com" --tags "productivity,ai,tools"

# Capture and open inbox for immediate editing
node scripts/capture.js "Meeting idea" --tags "work,ideas" --open

# Get help
node scripts/capture.js --help

Webhook Server

Start the webhook server for browser extension and API integration:

# Start the server
node scripts/webhook-server.js

# Server runs on http://localhost:3000
# Endpoints:
#   POST /capture    - Main capture endpoint
#   GET  /health     - Server health check
#   GET  /config     - Configuration for clients
#   GET  /captures   - Recent captures (debugging)

Webhook Usage

# Send capture via curl
curl -X POST http://localhost:3000/capture \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Webhook Test",
    "url": "https://example.com",
    "tags": ["test", "webhook"],
    "content": {"text": "Article content..."}
  }'

Web Clipper (Planned)

A browser extension is planned for one-click web page capture. See automation/webclipper_spec.md for the full specification.

Integration with Origin Byte

This workflow repository is designed to complement and feed into the main Origin Byte repository. Workflow outputs, processed notes, and completed artifacts should be regularly synchronized with Origin Byte for long-term storage and reference.

License

MIT License - see LICENSE file for details.