Skip to content

getting-started.md

Latest commit

 

History

History
82 lines (58 loc) · 2.14 KB

getting-started.md

File metadata and controls

82 lines (58 loc) · 2.14 KB
Raw

Getting Started

1. Install ggcode

See the Installation Guide for all available methods.

2. Configure Your API Key

On first run, ggcode auto-detects your environment and prompts for configuration:

ggcode

The onboarding wizard will:

  • Ask you to select a provider (Z.ai, OpenAI, Anthropic, etc.)
  • Prompt for your API key
  • Write the configuration to ~/.ggcode/ggcode.yaml
  • Store the API key securely in ~/.ggcode/keys.env

You can also manually create the config file. See Configuration for details.

Manual Setup

Create ~/.ggcode/ggcode.yaml:

vendor: openai
endpoint: default
model: gpt-4o

Then add your API key to ~/.ggcode/keys.env:

OPENAI_API_KEY=sk-your-key-here

Or set it via environment variable:

export OPENAI_API_KEY=sk-your-key-here

3. Start Chatting

ggcode

Type a message and press Enter. ggcode will:

  1. Send your message to the configured LLM
  2. Stream the response in real-time
  3. Execute any tool calls (file reads, searches, etc.) with your approval

Input Modes

The input supports three modes:

  • Normal (❯): Chat with the agent (default).
  • Shell ($): Type $ or ! to run shell commands inline. Exits after each command.
  • Chat (#): Type # to send LAN Chat messages to other ggcode instances. Stays active until Esc.

4. Essential Slash Commands

Command Description
/help Show available commands
/sessions List and resume sessions
/model [name] Switch model
/mode [mode] Switch permission mode (supervised/plan/auto/bypass/autopilot)
/compact Compact conversation to save context
/exit Exit ggcode

5. Next Steps