logggai/README.md

AI-powered CLI for transforming your development work into professional content

# Logggai CLI

Built for shipping. Track, enhance with AI, and share your changelogs and project updates — fast.

---

## 🚀 NEW: Project + Git Sync CLI

### **Synchronize your git commits as changelogs, powered by AI**

```bash
npx logggai project   # Initialize a project (local/cloud mapping)
npx logggai sync      # Sync your git commits as changelogs
npx logggai start     # Start the auto-sync daemon (background, per project)
```

- **Project mapping**: `.logggai-project.json` links your local repo to the cloud
- **AI Enhance**: Opt-in for each commit, edit before publishing
- **Multi-context**: Personal & Organization support
- **Publish**: Propose publication to LinkedIn, Notion, etc. at the end of the flow
- **Auto-Sync Daemon**: Background process, non-interactive, batches 20+ commits into a changelog, one daemon per project, anti-duplication, logs activity

#### **Example Workflow**
```bash
npx logggai project
# Answer prompts: project name, repo URL, context
# → Creates .logggai-project.json and cloud project

git commit -m "feat: add new API endpoint"
git commit -m "fix: bug in sync logic"
# ... 20+ commits ...

npx logggai start
# Daemon runs in background, auto-syncs when threshold is reached

npx logggai list
# View synced changelogs
```

---

### 🔄 Auto-Sync Daemon (NEW)

Automate your changelog sync with the background daemon:

```bash
npx logggai start   # Start the auto-sync daemon in the current project
```

- **One daemon per project** (anti-duplication, isolation)
- **Non-interactive**: No prompts, all defaults (AI Enhance ON, prompt style auto, title auto)
- **Batch sync**: When 20+ commits are detected, a changelog is auto-synced
- **Logs**: `.logggai-daemon.log` (activity), `.logggai-daemon.pid` (process)
- **Safe**: If already running, shows a warning and does not start a duplicate

#### Example

```bash
cd my-project
npx logggai project
# ... make commits ...
npx logggai start
# Daemon runs in background, auto-syncs when threshold is reached
```

#### Multi-projects
You can run one daemon per project directory. Each is fully isolated.

#### Troubleshooting
- To stop a daemon: `kill $(cat .logggai-daemon.pid)`
- If you see “already running”, the daemon is active for this project.
- If you have auth errors, run: `npx logggai logout && npx logggai login`

---

## Quick Start

No installation required! Use `npx` to get started immediately:

```bash
npx logggai register
npx logggai login
npx logggai post "My Development Journey"
```

## Features

- 🚀 **Zero Installation**: Use with `npx` - no global installation needed
- 🤖 **AI Enhancement**: Transform dev logs into professional content
- 📱 **Multi-Platform**: Publish to LinkedIn, Notion, and more
- 👥 **Team Ready**: Switch between personal and organization contexts
- 🔐 **Secure Auth**: Email authentication via Clerk (no Google/GitHub for now)
- 🔄 **Auto-Sync Daemon**: Background changelog sync, one daemon per project, non-interactive, batch at 20 commits
- 📦 **Project + Sync**: Map your repo, sync commits as changelogs (AI-powered)

## Commands

### Project & Git Sync (NEW)
```bash
npx logggai project   # Initialize a project (local/cloud mapping)
npx logggai sync      # Sync your git commits as changelogs (manual, interactive)
npx logggai start     # Start the auto-sync daemon (background, non-interactive)
```

### Account Management
```bash
npx logggai register    # Create new account
npx logggai login       # Login to existing account
npx logggai logout      # Logout current user
```

### Content Creation
```bash
npx logggai post "Title"                    # Create article with AI
npx logggai post "Title" -c "Content"       # With custom content
npx logggai post "Title" --no-ai            # Skip AI processing
npx logggai list                            # View recent articles
```

### Context Management
```bash
npx logggai context                         # Show current context
npx logggai switch mycompany                # Switch to organization
npx logggai switch                          # Switch to personal
```

### Project Mapping File
- `.logggai-project.json` stores:
  - `projectId`, `name`, `repo`, `lastSyncedCommit`, `contextType`, `contextId`
- Ensures smooth local/cloud sync and context switching
- `.logggai-daemon.pid` and `.logggai-daemon.log` are used by the daemon for process and activity tracking

---

## Documentation
- [Project + Sync CLI Spec](../../documentation/ROADMAP_SYNC/PROJECT_SYNC_IMPLEMENTATION.md)
- [CLI Reference](https://logggai.run/docs)

---

Made with ❤️ by [Thibault Souris](https://github.com/stranxik) & EDEN - Transforming development into content. 

> Logggai: The AI-powered CLI for devs who want their work to be seen 🚀