Cody AI

# Z marketplace
code --install-extension sourcegraph.cody-ai

# Lub przez VS Code:
# 1. Extensions (Ctrl+Shift+X)
# 2. Szukaj "Cody AI"
# 3. Install

# 1. Settings → Plugins → Marketplace
# 2. Szukaj "Cody"
# 3. Install → Restart IDE

-- W konfiguracji lazy.nvim
{
  "sourcegraph/sg.nvim",
  dependencies = { "nvim-lua/plenary.nvim" },
  config = function()
    require("sg").setup()
  end
}

┌─────────────────────────────────────────────────┐
│                   User Query                     │
│     "How does authentication work here?"         │
└─────────────────────┬───────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────┐
│              Context Retrieval                   │
│  1. Embeddings search (semantic similarity)      │
│  2. Code graph search (definitions, references)  │
│  3. Keyword search (traditional)                 │
└─────────────────────┬───────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────┐
│              Relevant Code                       │
│  - src/auth/middleware.ts                        │
│  - src/lib/session.ts                            │
│  - src/api/login.ts                              │
│  - src/types/auth.ts                             │
└─────────────────────┬───────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────┐
│              LLM Response                        │
│  "Based on src/auth/middleware.ts and           │
│   src/lib/session.ts, your app uses JWT         │
│   tokens with refresh mechanism..."              │
└─────────────────────────────────────────────────┘

User: How do we handle authentication?

Cody:
[Automatycznie znajduje auth-related files]

Based on your codebase, authentication is handled as follows:

1. **Login Flow** (src/api/auth/login.ts:23)
   - Users submit credentials to /api/auth/login
   - Credentials are validated against the database

2. **Session Management** (src/lib/session.ts:45)
   - JWT tokens are generated with 24h expiry
   - Refresh tokens stored in httpOnly cookies

3. **Middleware** (src/middleware/auth.ts:12)
   - All protected routes go through authMiddleware
   - Token verification using jose library

Here's the key code from your middleware:
[pokazuje relevant code snippet]

# Plik
@src/api/users.ts explain this file

# Folder
@lib/ what utilities do we have?

# Symbol
@UserService where is this class used?

# Repo (dla multi-repo)
@repo:backend explain the API structure

# Cały codebase
@codebase how is error handling done?

# Web (dokumentacja)
@web:https://react.dev/learn how do I use hooks?

/edit refactor to use TypeScript
/doc add documentation
/test write unit tests
/explain what does this do
/smell find code smells
/fix fix the errors

// Zaznacz ten kod
function processUser(user) {
  if (user.name) {
    return user.name.toUpperCase()
  }
  return 'Unknown'
}

// Wpisz: /edit convert to TypeScript with proper types

// Cody generuje:
interface User {
  name?: string
  email?: string
}

function processUser(user: User): string {
  if (user.name) {
    return user.name.toUpperCase()
  }
  return 'Unknown'
}

// Cody rozumie strukturę twojego projektu
// i sugeruje relevant code

import {
// Cody sugeruje: useAuth, useUser, useSession
// bazując na tym co jest używane w projekcie

// settings.json (VS Code)
{
  "cody.autocomplete.enabled": true,
  "cody.autocomplete.advanced.provider": "fireworks",
  "cody.autocomplete.advanced.model": "starcoder"
}

// Zaznacz problematyczny kod
const data = fetchData()
console.log(data.user.name)

// Cody (Cmd+K): "handle the null case"

// Wynik:
const data = fetchData()
if (data?.user?.name) {
  console.log(data.user.name)
} else {
  console.log('User data not available')
}

# Dodaj konkretny plik
@src/config/database.ts

# Dodaj folder
@lib/utils/

# Dodaj zewnętrzną dokumentację
@web:https://docs.prisma.io/concepts

# Połącz różne źródła
@src/api/ @web:https://trpc.io/docs explain how our API uses tRPC

// Ustawienia w VS Code
{
  "cody.chat.contextWindow": 16000,
  "cody.autocomplete.contextWindow": 4000
}

# Szukaj w wielu repozytoriach
@repo:frontend @repo:backend @repo:shared
How do we pass user data between frontend and backend?

# Cody przeszukuje wszystkie trzy repo
# i łączy kontekst w spójną odpowiedź

// .sourcegraph/config.json
{
  "repos": [
    "github.com/myorg/frontend",
    "github.com/myorg/backend",
    "github.com/myorg/shared-types"
  ],
  "codeIntelligence": {
    "languages": ["typescript", "python", "go"],
    "indexing": "precise"
  }
}

# docker-compose.yml (simplified)
version: '3'
services:
  sourcegraph:
    image: sourcegraph/server:latest
    ports:
      - "7080:7080"
    volumes:
      - sg-data:/var/opt/sourcegraph
    environment:
      - CODY_ENABLED=true
      - LLM_PROVIDER=anthropic
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}

{
  "cody.chat.preInstruction": "Use TypeScript. Follow our coding standards from CONTRIBUTING.md. Always include error handling.",
  "cody.customHeaders": {
    "X-Org-ID": "my-organization"
  }
}

// Dla Enterprise - kontrola dostępu do repo
{
  "cody.permissions": {
    "allowedRepos": [
      "github.com/myorg/public-*",
      "github.com/myorg/frontend"
    ],
    "deniedRepos": [
      "github.com/myorg/secrets-*"
    ]
  }
}

// settings.json
{
  // Włącz/wyłącz funkcje
  "cody.autocomplete.enabled": true,
  "cody.chat.enabled": true,
  "cody.commandHints.enabled": true,

  // Model settings
  "cody.chat.model": "claude-3-5-sonnet",

  // Autocomplete settings
  "cody.autocomplete.advanced.provider": "fireworks",
  "cody.autocomplete.advanced.model": "starcoder-7b",

  // Context settings
  "cody.contextSelection": {
    "embeddings": true,
    "keyword": true,
    "codeGraph": true
  },

  // Experimental features
  "cody.experimental.foldingRanges": true,
  "cody.experimental.localEmbeddings": true
}

Settings → Tools → Cody

- Enable Cody: ✓
- Chat Model: Claude 3.5 Sonnet
- Autocomplete: Enabled
- Custom Instructions: [your instructions]

# .cody/ignore
node_modules/
dist/
build/
*.min.js
*.map
coverage/
.env*
secrets/

# Użyj konkretnego modelu
/model claude-3-opus
How should I architect this microservice?

# Lub przez UI
# Kliknij dropdown przy input box i wybierz model

{
  "cody.enterprise.models": [
    {
      "name": "internal-codegen",
      "endpoint": "https://internal-api.company.com/v1/completions",
      "type": "completion"
    },
    {
      "name": "claude-via-bedrock",
      "endpoint": "https://bedrock.us-east-1.amazonaws.com",
      "type": "chat"
    }
  ]
}

@src/legacy/old-api/
This code was written 5 years ago. Explain:
1. What it does
2. Why it might have been written this way
3. How I should refactor it for modern standards

@codebase
I'm new to this project. Give me an overview of:
1. The overall architecture
2. Key technologies used
3. How to run it locally
4. Where to start for making changes to [feature]

@repo:api @repo:frontend @repo:mobile
We're changing the user authentication flow.
Show me all the places that need to be updated.

@diff
Review this pull request for:
- Potential bugs
- Performance issues
- Security concerns
- Adherence to our coding standards from @CONTRIBUTING.md

@src/api/users/
Generate API documentation for all endpoints in this folder.
Include:
- Request/response schemas
- Authentication requirements
- Example curl commands

# Cody automatycznie rozumie historię git
@git show me what changed in the last week
@git who worked on authentication recently?
@git explain this commit

# .github/workflows/cody-review.yml
name: Cody PR Review
on: [pull_request]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: sourcegraph/cody-action@v1
        with:
          token: ${{ secrets.SOURCEGRAPH_TOKEN }}
          action: review

# W Slacku
/cody search how do we handle payments?

# Cody przeszukuje codebase i odpowiada w wątku

# Sprawdź status indeksowania
# VS Code: View → Output → Cody

# Wymuś reindeksowanie
# Command Palette → "Cody: Refresh Local Embeddings"

{
  "cody.autocomplete.advanced.provider": "fireworks",
  "cody.autocomplete.advanced.timeout": 2000
}

# Wyloguj i zaloguj ponownie
# Command Palette → "Cody: Sign Out"
# Następnie → "Cody: Sign In"

# Zamiast ogólnego pytania:
"How does the app work?"

# Zadaj konkretne:
"@src/api @src/services How does the payment processing flow work from API endpoint to database?"

// .vscode/settings.json (współdzielone)
{
  "cody.chat.preInstruction": "Follow our TypeScript coding standards. Use functional components with hooks. Include error handling."
}

# From marketplace
code --install-extension sourcegraph.cody-ai

# Or through VS Code:
# 1. Extensions (Ctrl+Shift+X)
# 2. Search "Cody AI"
# 3. Install

# 1. Settings → Plugins → Marketplace
# 2. Search "Cody"
# 3. Install → Restart IDE

-- In lazy.nvim configuration
{
  "sourcegraph/sg.nvim",
  dependencies = { "nvim-lua/plenary.nvim" },
  config = function()
    require("sg").setup()
  end
}

┌─────────────────────────────────────────────────┐
│                   User Query                     │
│     "How does authentication work here?"         │
└─────────────────────┬───────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────┐
│              Context Retrieval                   │
│  1. Embeddings search (semantic similarity)      │
│  2. Code graph search (definitions, references)  │
│  3. Keyword search (traditional)                 │
└─────────────────────┬───────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────┐
│              Relevant Code                       │
│  - src/auth/middleware.ts                        │
│  - src/lib/session.ts                            │
│  - src/api/login.ts                              │
│  - src/types/auth.ts                             │
└─────────────────────┬───────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────┐
│              LLM Response                        │
│  "Based on src/auth/middleware.ts and           │
│   src/lib/session.ts, your app uses JWT         │
│   tokens with refresh mechanism..."              │
└─────────────────────────────────────────────────┘

User: How do we handle authentication?

Cody:
[Automatically finds auth-related files]

Based on your codebase, authentication is handled as follows:

1. **Login Flow** (src/api/auth/login.ts:23)
   - Users submit credentials to /api/auth/login
   - Credentials are validated against the database

2. **Session Management** (src/lib/session.ts:45)
   - JWT tokens are generated with 24h expiry
   - Refresh tokens stored in httpOnly cookies

3. **Middleware** (src/middleware/auth.ts:12)
   - All protected routes go through authMiddleware
   - Token verification using jose library

Here's the key code from your middleware:
[shows relevant code snippet]

# File
@src/api/users.ts explain this file

# Folder
@lib/ what utilities do we have?

# Symbol
@UserService where is this class used?

# Repo (for multi-repo)
@repo:backend explain the API structure

# Entire codebase
@codebase how is error handling done?

# Web (documentation)
@web:https://react.dev/learn how do I use hooks?

/edit refactor to use TypeScript
/doc add documentation
/test write unit tests
/explain what does this do
/smell find code smells
/fix fix the errors

// Select this code
function processUser(user) {
  if (user.name) {
    return user.name.toUpperCase()
  }
  return 'Unknown'
}

// Type: /edit convert to TypeScript with proper types

// Cody generates:
interface User {
  name?: string
  email?: string
}

function processUser(user: User): string {
  if (user.name) {
    return user.name.toUpperCase()
  }
  return 'Unknown'
}

// Cody understands the structure of your project
// and suggests relevant code

import {
// Cody suggests: useAuth, useUser, useSession
// based on what is used in the project

// settings.json (VS Code)
{
  "cody.autocomplete.enabled": true,
  "cody.autocomplete.advanced.provider": "fireworks",
  "cody.autocomplete.advanced.model": "starcoder"
}

// Select the problematic code
const data = fetchData()
console.log(data.user.name)

// Cody (Cmd+K): "handle the null case"

// Result:
const data = fetchData()
if (data?.user?.name) {
  console.log(data.user.name)
} else {
  console.log('User data not available')
}

# Add a specific file
@src/config/database.ts

# Add a folder
@lib/utils/

# Add external documentation
@web:https://docs.prisma.io/concepts

# Combine different sources
@src/api/ @web:https://trpc.io/docs explain how our API uses tRPC

// Settings in VS Code
{
  "cody.chat.contextWindow": 16000,
  "cody.autocomplete.contextWindow": 4000
}

# Search across multiple repositories
@repo:frontend @repo:backend @repo:shared
How do we pass user data between frontend and backend?

# Cody searches all three repos
# and combines context into a coherent answer

// .sourcegraph/config.json
{
  "repos": [
    "github.com/myorg/frontend",
    "github.com/myorg/backend",
    "github.com/myorg/shared-types"
  ],
  "codeIntelligence": {
    "languages": ["typescript", "python", "go"],
    "indexing": "precise"
  }
}

# docker-compose.yml (simplified)
version: '3'
services:
  sourcegraph:
    image: sourcegraph/server:latest
    ports:
      - "7080:7080"
    volumes:
      - sg-data:/var/opt/sourcegraph
    environment:
      - CODY_ENABLED=true
      - LLM_PROVIDER=anthropic
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}

{
  "cody.chat.preInstruction": "Use TypeScript. Follow our coding standards from CONTRIBUTING.md. Always include error handling.",
  "cody.customHeaders": {
    "X-Org-ID": "my-organization"
  }
}

// For Enterprise - repository access control
{
  "cody.permissions": {
    "allowedRepos": [
      "github.com/myorg/public-*",
      "github.com/myorg/frontend"
    ],
    "deniedRepos": [
      "github.com/myorg/secrets-*"
    ]
  }
}

// settings.json
{
  // Enable/disable features
  "cody.autocomplete.enabled": true,
  "cody.chat.enabled": true,
  "cody.commandHints.enabled": true,

  // Model settings
  "cody.chat.model": "claude-3-5-sonnet",

  // Autocomplete settings
  "cody.autocomplete.advanced.provider": "fireworks",
  "cody.autocomplete.advanced.model": "starcoder-7b",

  // Context settings
  "cody.contextSelection": {
    "embeddings": true,
    "keyword": true,
    "codeGraph": true
  },

  // Experimental features
  "cody.experimental.foldingRanges": true,
  "cody.experimental.localEmbeddings": true
}

Settings → Tools → Cody

- Enable Cody: ✓
- Chat Model: Claude 3.5 Sonnet
- Autocomplete: Enabled
- Custom Instructions: [your instructions]

# .cody/ignore
node_modules/
dist/
build/
*.min.js
*.map
coverage/
.env*
secrets/

# Use a specific model
/model claude-3-opus
How should I architect this microservice?

# Or through the UI
# Click the dropdown next to the input box and select a model

{
  "cody.enterprise.models": [
    {
      "name": "internal-codegen",
      "endpoint": "https://internal-api.company.com/v1/completions",
      "type": "completion"
    },
    {
      "name": "claude-via-bedrock",
      "endpoint": "https://bedrock.us-east-1.amazonaws.com",
      "type": "chat"
    }
  ]
}

@src/legacy/old-api/
This code was written 5 years ago. Explain:
1. What it does
2. Why it might have been written this way
3. How I should refactor it for modern standards

@codebase
I'm new to this project. Give me an overview of:
1. The overall architecture
2. Key technologies used
3. How to run it locally
4. Where to start for making changes to [feature]

@repo:api @repo:frontend @repo:mobile
We're changing the user authentication flow.
Show me all the places that need to be updated.

@diff
Review this pull request for:
- Potential bugs
- Performance issues
- Security concerns
- Adherence to our coding standards from @CONTRIBUTING.md

@src/api/users/
Generate API documentation for all endpoints in this folder.
Include:
- Request/response schemas
- Authentication requirements
- Example curl commands

# Cody automatically understands git history
@git show me what changed in the last week
@git who worked on authentication recently?
@git explain this commit

# .github/workflows/cody-review.yml
name: Cody PR Review
on: [pull_request]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: sourcegraph/cody-action@v1
        with:
          token: ${{ secrets.SOURCEGRAPH_TOKEN }}
          action: review

# In Slack
/cody search how do we handle payments?

# Cody searches the codebase and responds in the thread

# Check indexing status
# VS Code: View → Output → Cody

# Force reindexing
# Command Palette → "Cody: Refresh Local Embeddings"

{
  "cody.autocomplete.advanced.provider": "fireworks",
  "cody.autocomplete.advanced.timeout": 2000
}

# Log out and log in again
# Command Palette → "Cody: Sign Out"
# Then → "Cody: Sign In"

# Instead of a general question:
"How does the app work?"

# Ask something specific:
"@src/api @src/services How does the payment processing flow work from API endpoint to database?"

// .vscode/settings.json (shared)
{
  "cody.chat.preInstruction": "Follow our TypeScript coding standards. Use functional components with hooks. Include error handling."
}