Your First Session

Launch Gee-Code

Navigate to any project directory and start a session:

cd ~/my-project
gee-code

You’re now in an interactive session. Type natural language to give instructions, ask questions, or request changes.

The Basics

Ask a question

> What does the main() function in app.py do?

Gee-Code reads the file, analyzes it, and explains.

Edit code

> Add input validation to the create_user function in users.py

Gee-Code reads the file, makes targeted edits, and shows you exactly what changed.

Run a command

> Run the tests

Gee-Code executes your test runner and reports the results.

Named Sessions

You can maintain different conversations within the same codebase by using named sessions:

gee-code                    # Default session
gee-code auth-refactor      # Named session for auth work
gee-code bug-fix-422        # Named session for a specific bug

Each session maintains its own conversation history, context, and continuity state. Switch between them freely — they don’t interfere with each other.

Resume a previous session:

/resume

This shows you a list of recent sessions to pick from.

Adding Context

Gee-Code needs to see your files to work on them. There are several ways to bring files into context:

Paste content directly

Press Ctrl+V to paste text, code, error messages, screenshots — anything from your clipboard. Gee-Code will incorporate it into the conversation.

Use the file picker

/pick

This opens an interactive file browser. Navigate your project and select files to add to context.

Add specific files

/add src/auth/login.ts
/add package.json

Add files by path. Supports globs too:

/add src/components/*.tsx

What you have access to

Gee-Code can access:

• Your local filesystem — any file on your machine
• Your Gee account storage — files uploaded to Gee Cloud
• Google Drive — if your Gee account has authorized Google Drive access

Slash Commands

Commands start with / and control Gee-Code’s behavior:

Command	What it does
/help	Show all available commands
/status	Show running tasks and current state
/model sonnet	Switch to a different AI model
/clear	Start a fresh conversation
/history	View conversation history
/resume	Resume a previous session
/skills	List available skills
/agents	List available agents

There are 80+ commands in total. Type /help to explore them, or see the Commands reference.

Skills

Skills are on-demand capabilities that load specialized instructions. They’re invoked with slash commands:

/commit              # Craft a git commit with a good message
/explore src/        # Deep exploration of a directory
/init                # Generate project documentation

Skills extend what Gee-Code can do without bloating every conversation. They load only when you need them.

Using Your Claude Code Max Plan

If you have a Claude Max subscription, you can use it directly with Gee-Code — no API key needed.

1. Run /providers browse to check if Claude Code is detected
2. If not installed: curl -fsSL https://claude.ai/install.sh | bash, then run claude and select “Use subscription”
3. Activate with /clamp on cc (adaptive) or /clamp on cc-gee-max (max effort + all Gee tools)

See Models & Providers for the full setup guide.

What to Try Next

Now that you have the basics, here are some things to explore:

1. Plan a complex task — ask Gee-Code to refactor something. It will create a step-by-step plan you can review and execute.
2. Try different models — /model opus for the most capable, /model haiku for the fastest.
3. Use your Claude Code subscription — /clamp on cc routes everything through your Max plan.
4. Explore your codebase — /init generates comprehensive documentation about your project.
5. Customize your experience — set preferences in Configuration.

Next Steps

• How It Works — understand the execution model
• Commands — the full command system
• Context Management — master context techniques
• Configuration — customize behavior, models, and providers