sbctl

sbctl — Second Brain Controller

sbctl is a Go-based CLI tool designed to be the backbone of an AI-powered Second Brain. It manages the synchronization between Google Drive and a local SQLite database, exposing the data via an MCP (Model Context Protocol) server for seamless integration with AI agents like Claude.

🚀 Key Features

• GDrive Sync: Incremental metadata and content synchronization.
• SQLite Persistence: All your file metadata and Markdown content stored locally.
• MCP Server: Directly query your database from Claude via the Model Context Protocol.
• Systemd Integration: Runs as a reliable background service on Linux.
• Google Sheets Indexing: Automatically maintains a "Second Brain Index" in Google Sheets.

🛠️ Tech Stack

• Language: Go 1.21+
• CLI Framework: Cobra
• Database: SQLite (Pure Go, no CGO)
• Transport: MCP over HTTP/SSE
• Dependency: gog CLI for Google Drive access

📦 Installation

# Clone the repository
git clone https://github.com/kilip/sbctl.git
cd sbctl

# Build the binary
go build -o sbctl .

🚦 Quick Start

1. Initialise the environment:

   ./sbctl init
   

   This creates ~/.sbctl/config.json and ~/.sbctl/sbctl.db.

2. Configure your account:

   ./sbctl config gdrive.account="your-email@gmail.com"
   

3. Run your first sync:

   ./sbctl sync gdrive
   

📂 Project Structure

• cmd/: CLI commands implementation.
• internal/config/: Configuration handling (JSON).
• internal/db/: SQLite database and migrations.
• internal/worker/: Background worker logic (gdrive, mcp).
• internal/gog/: Wrapper for the gog CLI.

📄 License

MIT © 2026-present Anthonius Munthi https://kilip.github.io