Internal dev toolkit

go2tools

Claude Code project setup and orchestration toolkit

Requires WSL (Windows Subsystem for Linux). Run inside a WSL terminal. Install WSL
$ curl -fsSL https://g2t.go2digit.al/install -o /tmp/go2tools.sh
$ bash /tmp/go2tools.sh

Prompts for GitHub token, offers to save it, and optionally runs 1Password bootstrap.

$ export GITHUB_TOKEN=ghp_your_token
$ curl -fsSL https://g2t.go2digit.al/install | bash

Non-interactive. Set your token first. No prompts for bootstrap or saving.

curl -fsSL https://g2t.go2digit.al/install -o /tmp/go2tools.sh curl -fsSL https://g2t.go2digit.al/install.sha256 -o /tmp/go2tools.sha256 cd /tmp && sha256sum -c go2tools.sha256 && bash go2tools.sh

What happens

The installer runs five steps, each with clear output so you know exactly what is going on.

1

Detect OS & dependencies

Checks for bash 4+, git, jq, python3. Suggests install commands for missing packages on macOS, Debian, Fedora, Arch, and Alpine.

2

Resolve GitHub token

Reads token from environment or shell config, or prompts for it. Validates access to the private repo.

3

Clone go2tools

Clones the latest release (or pinned version) to ~/.go2tools. Switches remote to SSH for future updates.

4

Install CLI + shell completions

Adds go2tools to your PATH, installs zsh/bash completions, and offers to save the GitHub token to your shell config.

5

Bootstrap tokens + SSH

optional

Pulls all API tokens and SSH keys from 1Password in one command. Skips automatically in non-interactive (piped) installs.

CLI Preview

A single binary with 30+ commands covering the full development lifecycle.

~/my-project
$ go2tools init

Detect stack, pick agents, generate project config

$ go2tools link

Symlink agents and skills from centralized storage

$ go2tools doctor

Check dependencies, paths, MCP servers, symlinks

$ go2tools git-hooks

Install commit-msg and pre-commit validation hooks

$ go2tools task info PROJ-1234

Task summary with progress bar and pending items

$ go2tools orchestrate plan

Preview wave execution plan for parallel agents

$ go2tools wt PROJ-1234

Create isolated worktree for parallel development

$ go2tools checkpoint commit P1

Aggregate task gate-passes into checkpoint commit

$ go2tools analyse

7 agent health checks with auto-fix mode

$ go2tools optimize report

Token budget breakdown and recommendations

$ go2tools analytics week

Session token usage breakdown by period

$ go2tools status

Quick project health overview

85+
tests
45+
tech templates
50+
CLI commands
20+
specialized agents
15
dashboard pages

Features

Everything you need to run spec-driven Claude Code projects across teams and machines.

v4.7.0

Your Max Plan. Any Terminal.

G2Term ships with a local proxy that routes through your Claude Max subscription. Use Sonnet, Opus, or Haiku from any TUI — with slash commands, MCP tools, session management, and token tracking. Zero API costs, flat-rate billing.

New in v4.6

AI-Driven Project Optimizer

One click to eject, analyze, and auto-fix your Claude Code setup. Reads your codebase, fetches latest docs via Firecrawl, streams real-time analysis through your Max Plan proxy, then applies fixes with inline diffs.

Two-phase AI: analysis stream + structured fix generation (create, edit, delete agents)
Inline diff viewer — see before/after for every change, expandable per fix
Auto-backup to Google Drive with timestamped archives and one-click restore
Optimization history with full run logs, tool badges, and per-fix diffs
SweetAlert-style dialogs — pure CSS/JS, zero dependencies
Eject model: graduate from shared templates to fully tailored per-project setup

v4.6 Sprint

157 Tests. 7 Bugs Fixed. Cross-OS.

Full stability sprint: shell portability fixes, fish completions, orchestration wave dashboard, enhanced doctor, and comprehensive test coverage across macOS, Linux, and WSL.

Fish completions Shell portability Wave dashboard MCP health checks Searchable dropdowns Dynamic version badge Auto-stash self-update

New in v4.7

Skills Marketplace + AI Generator

22 skill templates with gallery, AI generator, cross-project matrix, and bulk install wizard. Describe a skill in plain English, Claude generates the SKILL.md. Install across all projects in one click.

Gallery + Presets

Browse 22 skills. One-click install by stack: PHP, React, Speckit, Quality.

AI Skill Generator

Describe what you need, Claude streams a complete SKILL.md via your Max Plan proxy.

Version Detection

SHA256 hash comparison. Outdated, customized, or current badges. Bulk update with one click.

Speckit Dashboard

Spec-Driven Dev Health

Bird's eye view of all projects: spec progress, task completion, gate passes, health scores. Charts for task completion and setup health. Quick Fix buttons per project.

Project readiness Feature details Charts

Session Handoff

Save Game for AI Sessions

Document everything, commit to session branch, auto-restart with full context. Pre-populated from git data. "CONTINUE FROM HERE" block so the next session knows exactly what to do.

Kernel mode Auto-restart Session cleanup

20 Language Servers

One Command. Every LSP.

Auto-detect your stack and install the right LSPs. PHP, TypeScript, Vue, Go, Python, Rust, Bash, CSS, YAML, Docker, Tailwind, Nix, Kotlin, Swift, and more. go2tools g2term lsp install handles everything cross-OS.

Smart Init + Project Wizard

Parses existing CLAUDE.md to detect your stack, picks relevant agents, generates docs/roadmap.md from 45+ tech templates. One click in the dashboard or one command in the terminal.

Spec-Driven Development

Tasks, drift-checker, and checkpoints keep implementation aligned with specs. Pre-commit hooks prevent structural regressions.

Centralized Agents

Link, sync, and import agents and skills across projects. Edit templates once, propagate everywhere via symlinks.

1Password Bootstrap

Pull all API tokens and SSH keys from 1Password onto a new machine. Cross-OS (macOS, Linux, WSL). Export your current setup with one command.

Git Worktrees

Parallel development per Jira ticket. Isolated checkouts with shared specs, vendor copy, and commit cherry-picking.

MCP Profiles

Switch between minimal, coding, research, and debug MCP configurations. Control token budget per session type.

Analytics Dashboard v4.6

20+ page web UI. AI optimizer with streaming, inline diffs, backup history. Token optimizer, PAL config, memory browser, orchestration waves, searchable dropdowns everywhere.

45+ Tech Templates

One-click templates for Laravel, React, Vue, Next.js, Go, Rust, Kotlin, Swift, Filament, Alpine.js, Algolia, Meilisearch, DDD/CQRS, PWA, SEO, and linting tools for every stack. Auto-resolves latest package versions.

G2Term TUI new

Rebranded Crush TUI with Claude Max Plan proxy. Slash commands, MCP integration, session management, and Claude Code tools via MCP server. Zero API costs.

Max Plan Proxy new

Go proxy server routes any TUI through your Claude Max Plan subscription. OAuth auth, SSE streaming, token tracking, request serialization. Flat-rate billing.

Cross-OS

Works on macOS, Linux, and WSL. Automatic path normalization, 1Password bridge for WSL biometrics, and OS-detected install commands.

Parallel Orchestration

Wave-based multi-agent execution. File boundary enforcement ensures agents never collide. MASTER_TASKS.md defines work packages, dependencies, and ownership.

Learning System

Extracts patterns from PR feedback, challenges you before implementation, tracks streaks and points. Prevents repeating the same review mistakes.

Health & Diagnostics

go2tools doctor checks dependencies, paths, MCP servers, symlinks. go2tools analyse runs 7 agent health checks with auto-fix mode.

Token Optimizer v3

8-check analysis with one-click auto-fix. Downgrades validation agents to Haiku, adds context isolation, fixes broken symlinks, resolves template variables. Shows optimization score and cost projections.

Super-Orchestrator v3

Master agent that intercepts all tasks. 3-tier complexity classifier (trivial/standard/complex), auto model selection per agent, and enforced pipeline sequencing. Zero manual routing.

PAL Multi-Model AI v3

Configure PAL tools and models from the dashboard. Toggle tools on/off, set per-tool model overrides, view cost projections. Auto-sync available models.

20 LSP Servers v4

Auto-detect your stack and install the right LSPs. PHP, TypeScript, Vue, Go, Python, Rust, Tailwind, Docker, YAML, and more. One command: go2tools g2term lsp install.

Agent Auto-Routing v4.5

Keyword-based prompt routing via UserPromptSubmit hooks. Define routes in agent-routes.json, and Claude auto-spawns the right agent. <40ms, no LLM overhead. Install with go2tools optimize guard install.

Cloud Backup v4.7

Auto-backup agents, skills, hooks, and CLAUDE.md to Google Drive after every optimization. Timestamped archives with one-click restore. Configurable path per project or globally.

Session Lifecycle v4.7

Auto-prune old session branches (30d) and docs (90d) with go2tools session cleanup. List all session docs across projects. Kernel mode for minimal context handoff. Pre-populated from git data.

Requirements

Runs on macOS and Linux. Minimal dependencies.

bash 4+
git
jq
python3
node + npm (optional, for MCP servers)