Personal agentic workflow: Freshworks ↔ Gitea ↔ Local development
npm install golem-ccPersonal agentic workflow manager. Integrates Freshservice tickets, Gitea issues, and Claude Code for a unified development workflow.
``bash`Bootstrap (one command)
pnpm dlx golem-cc
This copies everything to ~/.golem/, links binaries to ~/.local/bin/, and wires up Claude slash-commands.
After installing, restart your shell and configure:
`bashVerify setup
golem doctor
$3
bash
From a running install
golem installOr from a local checkout (dev workflow)
golem install --from /path/to/golem-cc
`Architecture
┌─────────────────────────────────────────────────────────────────────┐
│ GOLEM WORKFLOW │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ Freshservice Local State Gitea │
│ ┌─────────┐ ┌───────────┐ ┌─────────┐ │
│ │ INC-123 │◄──────►│.golem/ │◄──────►│ Issue │ │
│ │ Ticket │ │tickets/ │ │ #47 │ │
│ └─────────┘ │INC-123.yml│ └─────────┘ │
│ └───────────┘ │
│ │ │
│ ▼ │
│ ┌───────────┐ │
│ │ Worktree │ │
│ │ fix/INC- │ │
│ │ 123-slug │ │
│ └───────────┘ │
│ │ │
│ ┌───────────────┼───────────────┐ │
│ ▼ ▼ ▼ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │/golem: │ │/golem: │ │/golem: │ │
│ │spec │──►│plan │──►│build │ │
│ └──────────┘ └──────────┘ └──────────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │.golem/ │ │IMPLEMENT-│ │ wip: │ │
│ │specs/ │ │ATION_ │ │ commits │──► squash │
│ │*.md │ │PLAN.md │ └──────────┘ per stage │
│ └──────────┘ └──────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────┘
Quick Start
$3
bash
cd your-project
golem init
`$3
bash
Import existing Freshservice ticket
golem import INC-1234Or create new ticket
golem new "Fix API timeout issue"
`$3
bash
golem worktree INC-1234
cd .golem/worktrees/fix/INC-1234-api-timeout
`$3
/golem:spec
Interactive conversation to define requirements, tests, and constraints.
$3
/golem:plan
Generates
with staged tasks.$3
`bash
CLI - loops until done
golem buildOr in Claude Code - one task at a time
/golem:build
`Each task gets a WIP commit. Each stage gets squashed.
$3
bash
golem pr
`Commands
$3
| Command | Description |
|---------|-------------|
|
| Create new ticket |
| golem import | Import Freshservice ticket |
| golem list | List tracked tickets |
| golem status [ticket] | Show ticket or project status |
| golem worktree [ticket] | Create/show worktree |
| golem worktrees | List all worktrees |
| golem build | Run autonomous build loop |
| golem plan | Generate implementation plan |
| golem simplify [files] | Run code simplifier |
| golem squash | Squash stage commits |
| golem pr | Create pull request |
| golem sync | Sync status to Freshservice/Gitea |
| golem config | Show current configuration |
| golem doctor | Diagnose setup issues |
| golem init | Initialize golem in current project |
| golem help | Show help |$3
| Command | Description |
|---------|-------------|
|
/golem:spec | Define specs interactively |
| /golem:plan | Generate implementation plan |
| /golem:build | Run one build iteration |
| /golem:simplify | Run code simplifier |
| /golem:status | Show current status |
| /golem:config | Show configuration |
| /golem:doctor | Diagnose setup issues |
| /golem:help | Show help |Configuration
$3
`bash
~/.golem/.env
Freshservice
FRESH_DOMAIN=yourcompany.freshservice.com
FRESH_API_KEY=your_api_key
FRESH_DEFAULT_GROUP_ID=12345 # Optional
FRESH_DEFAULT_CATEGORY=Applications # Optional
FRESH_SOURCE_ID=1002 # Optional
FRESH_DEFAULT_EMAIL=bot@example.com # OptionalGitea
GITEA_URL=https://gitea.example.com
GITEA_TOKEN=your_token
GITEA_ORG=your-org
GITEA_REPO=default-repo # Can be overridden per-project
`$3
.golem/
├── tickets/ # Local ticket state (YAML)
│ └── INC-1234.yaml
├── specs/ # Requirement specs
│ ├── feature.md
│ └── validation.md
├── worktrees/ # Git worktrees per ticket
│ └── fix/INC-1234-api-timeout/
├── AGENTS.md # Operational commands (test/build/lint)
└── IMPLEMENTATION_PLAN.md # Current task list
MIT