Goblin
Personal productivity platform combining AI-powered development automation with financial management.
Goblin is a comprehensive platform with two integrated components:
| Component | Purpose |
|---|---|
| Goblin Core | Multi-agent orchestration for software development with Linear integration |
| Hello Goblin | AI-powered personal financial management webapp |
Goblin Core
Automates the software development lifecycle by orchestrating Claude Code agents through a structured pipeline.
Issue Assigned (Linear)
↓
┌───────────────────────────────────────────────┐
│ GOBLIN PIPELINE │
├───────────────────────────────────────────────┤
│ [SCOPER] → Analyzes issue, creates plan │
│ ↓ │
│ [BUILDER] → Implements code, commits │
│ ↓ │
│ [REVIEWER] → Reviews, auto-fixes ←───────┐ │
│ ↓ │ │
│ [TESTER] → Validates, runs QA ──────────┘ │
│ ↓ │
│ DONE → PR ready, reassigns to human │
└───────────────────────────────────────────────┘
Key Features
| Feature | Description |
|---|---|
| Linear-Native | Issues are the source of truth; progress syncs automatically |
| Multi-Agent Pipeline | Specialized agents for each development stage |
| Self-Healing Loops | Failed reviews return to build; failed tests return to review |
| Isolated Worktrees | Parallel work on multiple issues using git worktrees |
| Cloud & Local Preview | Docker Compose or EC2 preview environments |
| Static Analysis | Ruff + mypy integration in review stage |
| 7 Specialist Agents | CEO, Reviewer, DevOps, QA, Security, Performance, Docs |
Hello Goblin (Webapp)
AI-powered personal financial management with automated analysis, trading, and multi-source data integration.
Features
| Feature | Description |
|---|---|
| Multi-Source Data | Monarch Money, Plaid, Schwab, FRED integration |
| AI Analysis | Claude-powered spending analysis every 30 minutes |
| Automated Trading | AI-driven trade recommendations with safety controls |
| Debt Management | Avalanche, Snowball, Minimum payoff strategies |
| Notifications | SMS (Twilio), Email (SendGrid), Push (Firebase) |
| Economic Indicators | Federal Reserve data, Treasury rates, market sentiment |
Tech Stack
- Backend: Django 5.0 + Django REST Framework
- Frontend: React 18 + TypeScript + TailwindCSS
- Database: PostgreSQL 16 + Redis 7
- Task Queue: Celery 5.3 + Celery Beat
- AI: Anthropic Claude API
Quick Start
Goblin Core (Development Automation)
pip install goblin
goblin init
goblin auth --token YOUR_LINEAR_TOKEN --org your-org
goblin project add . --team ENG
goblin daemon
Hello Goblin (Financial Management)
goblin app up # Start webapp containers
goblin app open # Open in browser (localhost:3001)
goblin app logs # View logs
goblin app down # Stop webapp
Documentation
Goblin Core
| Section | Description |
|---|---|
| Getting Started | Installation, setup, configuration |
| Architecture | System design and components |
| Pipeline | Stage-by-stage workflow details |
| Agents | Individual agent documentation |
| Claude Integration | Context engineering and prompts |
| Cloud | Preview environment setup |
Hello Goblin Webapp
| Section | Description |
|---|---|
| Webapp Overview | Architecture and features |
| Finance | Accounts, transactions, debt tracking |
| AI Agent | Claude analysis and trading |
| Integrations | Monarch, Plaid, Schwab, FRED |
| API Reference | REST API endpoints |
Reference
| Section | Description |
|---|---|
| CLI Commands | All goblin commands |
| Configuration | Settings and environment variables |
| Database Schema | SQLite and PostgreSQL schemas |