Installation

Building from Source#

# Clone the repository
git clone https://github.com/ginkida/gokin.git
cd gokin

# Build
go build -o gokin ./cmd/gokin

# Build with version
go build -ldflags "-X main.version=1.0.0" -o gokin ./cmd/gokin

# Install to GOPATH/bin
go install ./cmd/gokin

Requirements#

Go 1.25+ — to build from source
macOS / Linux / Windows — cross-platform support
Terminal with Unicode — for correct TUI rendering

Initial Setup#

# Interactive setup wizard
./gokin --setup

The wizard will prompt you to:

Choose a provider — Gemini OAuth, Gemini API, GLM, DeepSeek, Anthropic, MiniMax, Kimi, Ollama
Enter an API key — with real-time validation
Configure a model — with recommended defaults

For Ollama, no API key is required — just a running server on localhost:11434.

Updating#

# Check for updates
gokin update --check

# Install update
gokin update install

# List saved backups
gokin update backups

Rollback System#

Each update automatically creates a backup of the current binary.

# Roll back to the latest backup
gokin update rollback

# Roll back to a specific backup
gokin update rollback <backup-id>

Update system parameters:

Parameter	Default	Description
`update.enabled`	`true`	Enable update checks
`update.check_interval`	`24h`	Check interval
`update.auto_update`	`false`	Auto-install updates
`update.max_backups`	`3`	Maximum backup count

Backups are stored in ~/.config/gokin/update/backups/ and include a SHA256 checksum for verification.

File Structure#

After installation and first run:

~/.config/gokin/
├── config.yaml              # Configuration
├── gokin.log                # Log (disabled by default)
├── provider_health.json     # Provider health scores
├── memory/
│   ├── delegation_metrics.json
│   └── ...
├── sessions/                # Saved sessions
├── audit/                   # Audit logs
└── update/
    └── backups/             # Binary backups