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

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

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:

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

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:

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)

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

npx logggai register    # Create new account
npx logggai login       # Login to existing account
npx logggai logout      # Logout current user

Content Creation

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

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
• CLI Reference

Made with ❤️ by Thibault Souris & EDEN - Transforming development into content.

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