GitLink Code (gc)

AI coding agent CLI with full DevOps lifecycle integration.

Quick Start

# Configure API key (one-time)
mkdir -p ~/.gc
cat > ~/.gc/settings.json << 'EOF'
{
  "providers": {
    "deepseek": {
      "apiKey": "sk-your-key-here"
    }
  }
}
EOF

# Install & run
npm install -g gitlink-code
gc

Or with environment variable:

export DEEPSEEK_API_KEY="sk-..."
npx gc

CLI Entry Points

| Command | Behavior | |---------|----------| | gc | Interactive AI coding agent | | gitlink code | Subcommand form (same as gc) | | gitlinkcode | Alias (same as gc) | | gitlink --help | Show all commands |

Configuration

Config priority (low → high): defaults → ~/.gc/settings.json → .gc/settings.json → env vars → CLI flags

~/.gc/settings.json

{
  "model": "deepseek-v4-pro",
  "permissionMode": "default",
  "providers": {
    "deepseek": {
      "apiKey": "sk-...",
      "baseUrl": "https://api.deepseek.com",
      "model": "deepseek-v4-pro",
      "maxTokens": 8192
    }
  }
}

Project config

Place CLAUDE.md, .gc/config.md, or .gc/settings.json in your project root for project-specific instructions and overrides.

Features

• Interactive TUI — Rich terminal interface with markdown rendering, diff view, tool cards
• Non-interactive mode — gc --print "query" for one-shot questions
• Slash Commands — /specify, /plan, /implement, /validate spec-anchored development
• DevOps Full-Cycle — PR review, CI/CD diagnosis, issue management, release notes
• Skills System — SKILL.md with conditional activation (gitignore-style path patterns)
• Multi-Agent Pipeline — Planner → Executor → Evaluator with context isolation
• Three-Tier Memory — Working memory, session memory, persistent knowledge base
• Permission Engine — Rule-based allow/ask/deny

CLI Options

-m, --model <model>         Model to use
-p, --print <query>         Non-interactive mode
--provider <name>           AI provider: deepseek, anthropic, openai
--provider-key <key>        API key for the selected provider
--permission-mode <mode>    default | acceptEdits | bypassPermissions
--project <path>            Project directory
--max-turns <n>             Max turns (default: 25)
--workflow <name>           Execute a workflow (non-interactive)
--workflow-list             List available workflows
--workflow-vars <vars...>   Workflow variables (key=value)

Slash Commands

| Command | Description | |---------|-------------| | /help | Show available commands | | /specify | Generate SPEC.md from feature description | | /plan | Generate PLAN.md + TASKS.md | | /implement | Execute tasks from TASKS.md | | /validate | Validate implementation against SPEC | | /pr-list | List pull requests | | /pr-review | Review a PR | | /ci-status | List CI builds | | /ci-debug | Diagnose CI failure | | /release-notes | Generate release notes | | /sprint-status | Generate sprint status report |

Documentation

• User Guide — Full install & config guide (published to npm)
• Publish Guide — How to bundle & publish
• Skills Guide — SKILL.md format
• SDD Guide — Spec-anchored development
• Architecture

Development

# Dev mode (with source)
npm run dev

# Bundle for release
npm run bundle

# Publish
./tools/publish.sh --publish

License

MIT