auggie-context

# Auggie Context Plugin

A context management and codebase exploration plugin for Claude Code, powered by the [Auggie SDK](https://docs.augmentcode.com/cli/sdk) and [Context Engine SDK](https://docs.augmentcode.com/context-services/sdk/overview).

## Features

- **`/auggie`**: Context-aware codebase assistant
- **`/auggie-setup`**: Configure Auggie credentials
- **`/auggie-index`**: Index your codebase for fast context search
- **Auggie Agent**: Specialized subagent for codebase exploration
- **Auggie Skill**: Automatic context-aware assistance

## Getting Started

### Step 1: Install the Plugin

```bash
# Add the 1wp-plugins marketplace
/plugin marketplace add vleytman/1wp-plugins

# Install the plugin
/plugin install auggie-context@1wp-plugins
```

### Step 2: Set Up Credentials

```bash
/auggie-setup
```

Or manually:

```bash
# Install Auggie CLI (if not installed)
# See: https://docs.augmentcode.com/cli

# Login to Auggie
auggie login

# Verify it worked
auggie token print
```

Restart Claude Code after logging in.

### Step 3: Index Your Codebase

```bash
/auggie-index
```

This creates `auggie-context.json` which persists your index between sessions.

### Step 4: Start Using

```bash
/auggie How does the authentication system work?
/auggie Find all API endpoints
/auggie Explain the data flow in this component
```

## Commands

| Command | Description |
|---------|-------------|
| `/auggie [query]` | Ask questions about your codebase |
| `/auggie-setup` | Configure Auggie credentials |
| `/auggie-index` | Index or re-index the codebase |

## How It Works

1. **Authentication**: Uses `auggie login` which stores credentials in `~/.augment/session.json`
2. **Indexing**: Uses DirectContext API to index files and persist state to `auggie-context.json`
3. **Search**: Queries are processed by Auggie's context engine for relevant code snippets
4. **Persistence**: Index state is saved locally, enabling fast incremental updates

## FAQ / Troubleshooting

### "Auggie not configured" error

Run `/auggie-setup` or:
```bash
auggie login
```
Then restart Claude Code.

### "Command not found: auggie"

Install the Auggie CLI:
- Visit https://docs.augmentcode.com/cli
- Follow installation instructions for your platform

### Index seems stale or incomplete

Re-run the indexing command:
```bash
/auggie-index
```

### "Not authenticated" or token errors

Your session may have expired. Re-authenticate:
```bash
auggie login
```

### How do I check if I'm authenticated?

```bash
auggie token print
```

If it shows `accessToken` and `tenantURL`, you're good.

### Where are credentials stored?

Credentials are stored in `~/.augment/session.json` (created by `auggie login`). This file is outside your project and not committed to git.

### Where is the index stored?

The index is stored in `auggie-context.json` in your project root. This file:
- Is project-specific
- Should be in `.gitignore` (added automatically)
- Is regenerated by `/auggie-index`

### How do I keep the index up to date?

Run `/auggie-index` after making significant changes to your codebase. The indexing is incremental - only changed files are re-processed.

### Large codebase taking too long to index?

- Ensure you have a `.gitignore` file to exclude `node_modules/`, build artifacts, etc.
- You can also create an `.augmentignore` file for additional exclusions

## License

MIT