@ishaan812/devlog 0.0.1

package/README.md

@@ -0,0 +1,497 @@
+<div align="center">
+
+```
+     _            _
+  __| | _____   _| | ___   __ _
+ / _` |/ _ \ \ / / |/ _ \ / _` |
+| (_| |  __/\ V /| | (_) | (_| |
+ \__,_|\___| \_/ |_|\___/ \__, |
+                           |___/
+```
+
+### Stop forgetting what you shipped.
+
+Open-source, local-first AI work logging for developers who juggle<br>too many repos, too many branches, and too many standups.
+
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Go Version](https://img.shields.io/badge/go-%3E%3D1.21-blue.svg)](https://go.dev)
+[![Open Source](https://img.shields.io/badge/open%20source-%E2%9C%93-brightgreen.svg)](https://github.com/ishaan812/devlog)
+[![npm](https://img.shields.io/badge/npm-%40ishaan812%2Fdevlog-red.svg)](https://www.npmjs.com/package/@ishaan812/devlog)
+
+</div>
+
+You ship code across 5 repos, 12 branches, and 3 teams. Monday morning standup hits and you're scrolling through `git log` trying to remember what you did last Thursday.
+
+**DevLog fixes that.** It ingests your git history across every repo and branch you work on, and turns it into smart, structured work logs — automatically. No more "I think I worked on the auth thing?" Ask DevLog and get an answer in seconds.
+
+---
+
+### The 30-second pitch
+
+```bash
+npm install -g @ishaan812/devlog  # Install
+devlog onboard              # Set up (works with free local Ollama)
+devlog ingest               # Point it at your repos
+devlog worklog --days 7     # Get your week's work, organized by branch
+```
+
+That's it. Professional markdown work logs, generated from your actual commits. Multi-repo, multi-branch, zero effort.
+
+---
+
+## Why Developers Love DevLog
+
+### You context-switch constantly
+You're on `feature/payments` in the morning, hotfixing `prod` after lunch, reviewing PRs on a backend service, then back to payments. DevLog tracks all of it — across repos and branches — so you don't have to.
+
+### Your standups are painful
+"What did I do yesterday?" shouldn't require 10 minutes of archaeology through git logs in 4 different terminals. DevLog generates a clean, branch-organized summary in one command.
+
+### You work across multiple repos
+Frontend, backend, shared libraries, infrastructure — DevLog ingests them all into one unified timeline. One command to see everything you shipped.
+
+### You care about privacy (and your wallet)
+DevLog is **local-first**. Run it with [Ollama](https://ollama.ai) and your data never leaves your machine. No subscriptions, no telemetry, no cloud dependency. Need better summaries? Plug in Anthropic, OpenAI, or OpenRouter for pennies per query.
+
+---
+
+## Features
+
+| Feature | Description |
+|---------|-------------|
+| **Smart Work Logs** | Auto-generated markdown summaries organized by branch, date, and repo — ready for standups, PRs, or performance reviews |
+| **Multi-Repo Ingestion** | Ingest as many repos as you want into a single profile. See your full picture. |
+| **Multi-Branch Tracking** | Branch-aware ingestion remembers your selections per repo. Track `main`, `develop`, and every feature branch. |
+| **Local-First AI** | Works completely offline with Ollama. Your code and history stay on your machine. |
+| **Cheap Cloud Fallback** | Optionally use Anthropic, OpenAI, OpenRouter, or AWS Bedrock — most queries cost fractions of a cent |
+| **Natural Language Queries** | Ask questions about your git history in plain English |
+| **Semantic Code Search** | Find code by describing what it does, not just grepping keywords |
+| **Profile System** | Isolated databases for work vs. personal, or per-client contexts |
+| **Incremental Updates** | Re-runs only process new commits. Fast even on large repos. |
+| **Codebase Visualization** | Generate structure diagrams and collaboration graphs |
+
+## Quick Start
+
+```bash
+# 1. Install DevLog
+npm install -g devlog
+# or: go install github.com/ishaan812/devlog/cmd/devlog@latest
+
+# 2. Run the setup wizard (picks up Ollama automatically)
+devlog onboard
+
+# 3. Ingest your repositories
+devlog ingest ~/projects/frontend
+devlog ingest ~/projects/backend
+devlog ingest ~/projects/shared-lib
+
+# 4. See what you actually shipped
+devlog worklog --days 7
+devlog ask "What did I work on this week?"
+devlog search "error handling"
+```
+
+## Installation
+
+### Using npm (Easiest)
+
+```bash
+npm install -g @ishaan812/devlog
+```
+
+### Using Go Install
+
+```bash
+go install github.com/ishaan812/devlog/cmd/devlog@latest
+```
+
+### From Source
+
+```bash
+git clone https://github.com/ishaan812/devlog
+cd devlog
+make install
+```
+
+### Verify Installation
+
+```bash
+devlog --help
+```
+
+## Getting Started
+
+### 1. Initial Setup
+
+Run the onboarding wizard to configure your LLM provider:
+
+```bash
+devlog onboard
+```
+
+This will:
+- Set up your preferred LLM provider (Ollama recommended for privacy)
+- Configure your user identity for commit tracking
+- Create your default profile
+
+### 2. Ingest a Repository
+
+Navigate to your project and run:
+
+```bash
+cd ~/projects/myapp
+devlog ingest
+```
+
+On first run, you'll select which branches to track. DevLog remembers your selection:
+```
+  Saved branch selection:
+    Main: main
+    Branches: main, develop, feature/auth
+
+  [Enter] Use current  [m] Modify  [r] Reselect all: 
+```
+
+### 3. Generate Work Logs
+
+```bash
+devlog worklog --days 7
+```
+
+One command. Every repo. Every branch. Organized and summarized:
+
+```markdown
+# Work Log - yourname
+
+*Generated on February 4, 2026*
+
+# Monday, February 3, 2026
+
+## repo: frontend | Branch: feature/payments
+
+### Updates
+- Built the checkout flow with Stripe integration
+- Added client-side form validation for card inputs
+
+### Commits
+- **16:45** `f8a9b0c` Add Stripe checkout component (+320/-15)
+- **14:20** `c3d4e5f` Add card validation helpers (+95/-10)
+
+## repo: backend | Branch: feature/auth
+
+### Updates
+- Implemented JWT-based authentication with refresh tokens
+- Added role-based access control middleware
+
+### Commits
+- **11:30** `a1b2c3d` Add JWT authentication (+250/-30)
+- **09:15** `d4e5f6g` Implement RBAC middleware (+180/-20)
+```
+
+That's your standup, done. Copy-paste it, email it, or drop it in Slack.
+
+### 4. Query Your Activity
+
+```bash
+# Ask natural language questions
+devlog ask "What features did I add this month?"
+devlog ask "Show me commits related to the payment system"
+devlog ask "Which files have I changed the most?"
+
+# Semantic code search
+devlog search "database connection pooling"
+devlog search "user authentication flow"
+```
+
+## Commands Reference
+
+### `devlog ingest`
+
+Ingest git history and index your codebase for search.
+
+```bash
+devlog ingest                      # Current directory
+devlog ingest ~/projects/myapp     # Specific path
+devlog ingest --days 90            # Last 90 days (default: 30)
+devlog ingest --all                # Full git history
+devlog ingest --git-only           # Skip codebase indexing
+devlog ingest --index-only         # Skip git history
+devlog ingest --reselect-branches  # Re-select branches
+devlog ingest --all-branches       # Ingest all branches
+devlog ingest --fill-summaries     # Generate missing commit summaries
+```
+
+### `devlog ask`
+
+Query your development activity using natural language.
+
+```bash
+devlog ask "What did I work on this week?"
+devlog ask "Show commits about authentication"
+devlog ask "Which files changed the most in January?"
+devlog ask --provider anthropic "Summarize my recent work"
+```
+
+### `devlog search`
+
+Semantic search across your indexed codebase.
+
+```bash
+devlog search "authentication logic"
+devlog search "database queries"
+devlog search -n 20 "error handling"    # More results
+```
+
+### `devlog worklog`
+
+Generate formatted work logs from your commit history.
+
+```bash
+devlog worklog                     # Default: last 7 days
+devlog worklog --days 30           # Last 30 days
+devlog worklog -o report.md        # Custom output file
+devlog worklog --no-llm            # Skip AI summaries
+devlog worklog --group-by date     # Group by date instead of branch
+```
+
+### `devlog profile`
+
+Manage isolated profiles for different work contexts.
+
+```bash
+devlog profile                     # Show current profile
+devlog profile list                # List all profiles
+devlog profile create work "Work projects"
+devlog profile use work            # Switch profiles
+devlog profile repos               # List repos in profile
+devlog profile delete old          # Delete a profile
+```
+
+Use a profile temporarily:
+```bash
+devlog --profile work ingest ~/work/project
+devlog --profile personal ask "What did I do this weekend?"
+```
+
+### `devlog graph`
+
+Visualize your codebase structure.
+
+```bash
+devlog graph                       # Folder structure
+devlog graph --type commits        # Commit activity
+devlog graph --type files          # File change heatmap
+devlog graph --type collab         # Developer collaboration
+devlog graph -o diagram.md         # Export as Mermaid markdown
+```
+
+### `devlog list`
+
+List profiles and repositories.
+
+```bash
+devlog list                        # All profiles with stats
+devlog list repos                  # Repos in current profile
+```
+
+### `devlog clear`
+
+Clear database data for the current profile.
+
+```bash
+devlog clear                       # Interactive confirmation
+devlog clear --force               # Skip confirmation
+```
+
+## LLM Providers — Use What You Already Have
+
+DevLog doesn't lock you into an expensive API. Start free and local, upgrade if you want.
+
+| Provider | Privacy | Cost | Best For |
+|----------|---------|------|----------|
+| **Ollama** | 🟢 Fully local | Free | Default. Your data never leaves your machine. |
+| **OpenRouter** | 🟡 Cloud | ~$0.001/query | Cheap access to dozens of models |
+| **Anthropic** | 🟡 Cloud | Paid | Best quality summaries |
+| **OpenAI** | 🟡 Cloud | Paid | Wide model selection |
+| **Bedrock** | 🟡 Cloud | Paid | AWS-integrated workflows |
+
+### Setting Up Ollama (Recommended — Free & Private)
+
+```bash
+# 1. Install Ollama (ollama.ai)
+# 2. Pull a model
+ollama pull llama3.2
+
+# 3. Start the server
+ollama serve
+
+# 4. DevLog will detect it automatically
+devlog onboard
+```
+
+No API keys. No accounts. No usage limits. Just your machine.
+
+### Using Cloud Providers
+
+Set your API key during onboarding or in `~/.devlog/config.json`:
+
+```json
+{
+  "default_provider": "anthropic",
+  "anthropic_api_key": "sk-ant-..."
+}
+```
+
+Or use environment variables:
+```bash
+export ANTHROPIC_API_KEY="sk-ant-..."
+export OPENAI_API_KEY="sk-..."
+```
+
+## Configuration
+
+DevLog stores all data in `~/.devlog/`:
+
+```
+~/.devlog/
+├── config.json              # Settings, profiles, API keys
+└── profiles/
+    ├── default/
+    │   └── devlog.db        # SQLite database
+    └── work/
+        └── devlog.db
+```
+
+### Config Options
+
+| Setting | Description | Default |
+|---------|-------------|---------|
+| `default_provider` | LLM provider | `ollama` |
+| `ollama_model` | Model for Ollama | `llama3.2` |
+| `ollama_base_url` | Ollama server URL | `http://localhost:11434` |
+| `user_email` | Your git email | Auto-detected |
+| `github_username` | GitHub username | Optional |
+
+## Tips & Tricks
+
+### Faster Ingestion
+
+Skip AI summaries for quick ingestion:
+```bash
+devlog ingest --skip-summaries --skip-commit-summaries
+```
+
+### Generate Summaries Later
+
+Fill in missing summaries after fast ingestion:
+```bash
+devlog ingest --fill-summaries
+```
+
+### Multiple Repos, One Timeline
+
+Ingest every repo you touch — DevLog unifies them:
+```bash
+devlog ingest ~/projects/frontend
+devlog ingest ~/projects/backend
+devlog ingest ~/projects/shared-lib
+devlog worklog --days 7  # See everything in one report
+```
+
+### Work vs Personal — Completely Isolated
+
+Profiles give you separate databases. No bleed between contexts:
+```bash
+devlog profile create work "Work projects"
+devlog profile use work
+devlog ingest ~/work/project1
+
+devlog profile use default  # Back to personal
+```
+
+## Shell Completion
+
+Enable tab completion for your shell:
+
+```bash
+# Bash
+devlog completion bash > /etc/bash_completion.d/devlog
+
+# Zsh
+devlog completion zsh > "${fpath[1]}/_devlog"
+
+# Fish
+devlog completion fish > ~/.config/fish/completions/devlog.fish
+```
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/ishaan812/devlog
+cd devlog
+
+# Build
+make build
+
+# Run tests
+make test
+
+# Install locally
+make install
+
+# Run development commands
+make run-ingest
+make run-ask
+make run-worklog
+```
+
+## Documentation
+
+- [Quick Start Guide](guides/quickstart.md)
+- [LLM Provider Setup](guides/providers.md)
+- [Ollama Setup Guide](guides/ollama-setup.md)
+
+## Troubleshooting
+
+### "No commits found"
+Make sure you've run `devlog ingest` first:
+```bash
+devlog ingest
+```
+
+### "LLM not available"
+Check your provider is configured:
+```bash
+devlog onboard  # Re-run setup
+```
+
+For Ollama, ensure the server is running:
+```bash
+ollama serve
+```
+
+### Slow ingestion
+Skip AI summaries for faster initial ingestion:
+```bash
+devlog ingest --skip-summaries
+```
+
+## Who Is This For?
+
+- **Individual developers** who work across multiple repos and branches and need clean work logs for standups, weekly reports, or performance reviews
+- **Freelancers & contractors** who bill by the hour and need to show clients what was delivered
+- **Open source maintainers** who want to generate changelogs and activity summaries
+- **Anyone tired of `git log --oneline | head -50`** as a standup prep strategy
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+---
+
+**Built for developers who ship faster than they can remember.** Star the repo if DevLog saves your next standup.

package/bin/devlog-wrapper.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+
+const { execFileSync } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+
+const isWindows = process.platform === "win32";
+const binaryName = isWindows ? "devlog.exe" : "devlog";
+const binaryPath = path.join(__dirname, binaryName);
+
+if (!fs.existsSync(binaryPath)) {
+  console.error(
+    "Error: devlog binary not found. Try reinstalling:\n" +
+      "  npm install -g @ishaan812/devlog\n" +
+      "\nOr install via Go:\n" +
+      "  go install github.com/ishaan812/devlog/cmd/devlog@latest"
+  );
+  process.exit(1);
+}
+
+try {
+  const result = execFileSync(binaryPath, process.argv.slice(2), {
+    stdio: "inherit",
+    env: process.env,
+  });
+} catch (error) {
+  if (error.status !== null) {
+    process.exit(error.status);
+  }
+  process.exit(1);
+}

package/install.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const VERSION = require('./package.json').version;
+
+// Map Node.js platform/arch to Go build names
+const PLATFORM_MAP = {
+  'darwin-x64': 'darwin-amd64',
+  'darwin-arm64': 'darwin-arm64',
+  'linux-x64': 'linux-amd64',
+  'linux-arm64': 'linux-arm64',
+  'win32-x64': 'windows-amd64'
+};
+
+function getPlatform() {
+  const platform = process.platform;
+  const arch = process.arch;
+  const key = `${platform}-${arch}`;
+  
+  const goPlatform = PLATFORM_MAP[key];
+  if (!goPlatform) {
+    throw new Error(`Unsupported platform: ${platform}-${arch}`);
+  }
+  
+  return goPlatform;
+}
+
+function download(url, dest) {
+  return new Promise((resolve, reject) => {
+    console.log(`Downloading devlog binary from ${url}...`);
+    
+    const file = fs.createWriteStream(dest);
+    https.get(url, (response) => {
+      if (response.statusCode === 302 || response.statusCode === 301) {
+        // Follow redirect
+        return download(response.headers.location, dest).then(resolve).catch(reject);
+      }
+      
+      if (response.statusCode !== 200) {
+        reject(new Error(`Failed to download: ${response.statusCode}`));
+        return;
+      }
+      
+      response.pipe(file);
+      file.on('finish', () => {
+        file.close();
+        resolve();
+      });
+    }).on('error', (err) => {
+      fs.unlink(dest, () => {});
+      reject(err);
+    });
+  });
+}
+
+async function install() {
+  try {
+    const platform = getPlatform();
+    const isWindows = platform.includes('windows');
+    const binaryName = isWindows ? 'devlog.exe' : 'devlog';
+    const binDir = path.join(__dirname, 'bin');
+    const binaryPath = path.join(binDir, binaryName);
+    
+    // Create bin directory if it doesn't exist
+    if (!fs.existsSync(binDir)) {
+      fs.mkdirSync(binDir, { recursive: true });
+    }
+    
+    // Download URL - adjust this based on where you host binaries
+    const downloadUrl = `https://github.com/ishaan812/devlog/releases/download/v${VERSION}/devlog-${platform}${isWindows ? '.exe' : ''}`;
+    
+    await download(downloadUrl, binaryPath);
+    
+    // Make executable on Unix systems
+    if (!isWindows) {
+      fs.chmodSync(binaryPath, 0o755);
+    }
+    
+    console.log('✓ devlog installed successfully!');
+  } catch (error) {
+    console.error('Failed to install devlog:', error.message);
+    console.error('\nYou can install devlog using Go instead:');
+    console.error('  go install github.com/ishaan812/devlog/cmd/devlog@latest');
+    process.exit(1);
+  }
+}
+
+install();

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@ishaan812/devlog",
+  "version": "0.0.1",
+  "description": "AI-powered development activity tracker and code intelligence tool. Local-first work logging for developers who juggle too many repos.",
+  "bin": {
+    "devlog": "./bin/devlog-wrapper.js"
+  },
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ishaan812/devlog.git"
+  },
+  "homepage": "https://github.com/ishaan812/devlog#readme",
+  "bugs": {
+    "url": "https://github.com/ishaan812/devlog/issues"
+  },
+  "keywords": [
+    "git",
+    "cli",
+    "devlog",
+    "developer-tools",
+    "activity-tracker",
+    "work-log",
+    "standup",
+    "ai",
+    "llm",
+    "ollama",
+    "productivity"
+  ],
+  "author": "ishaan812",
+  "license": "MIT",
+  "files": [
+    "bin/devlog-wrapper.js",
+    "install.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=14"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}