# Context Manage

> Manage Kurtosis contexts for connecting to different Kurtosis instances. Add, list, switch, and remove contexts. Use when working with multiple Kurtosis environments (local, remote, team shared).

- Skill: `kurtosis-tech/context-manage` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kurtosis-tech/context-manage`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kurtosis-tech/context-manage/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kurtosis-tech (https://skillmd.com/u/kurtosis-tech)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kurtosis-tech/context-manage

---


# Context Manage

Manage Kurtosis contexts for connecting to different Kurtosis instances.

## What are contexts?

Contexts define which Kurtosis instance the CLI talks to. The default context is `default` which connects to the local engine (Docker or Kubernetes).

## List contexts

```bash
kurtosis context ls
```

Shows all configured contexts and which one is active.

## Add a context

```bash
kurtosis context add <context-name>
```

## Switch context

```bash
kurtosis context set <context-name>
```

After switching, restart the engine or portal as needed.

## Remove a context

```bash
kurtosis context rm <context-name>
```

## Common workflow

```bash
# Check which context is active
kurtosis context ls

# Switch to a different environment
kurtosis context set staging

# Verify the switch succeeded
kurtosis context ls

# Start portal if using a remote context
kurtosis portal start

# Switch back to local
kurtosis context set default
```

## Error handling

| Scenario | Behavior | Resolution |
|----------|----------|------------|
| Switch to non-existent context | Command fails with error | Run `kurtosis context ls` to see available contexts |
| Remove active context | Command fails — cannot remove active | Switch to another context first with `kurtosis context set` |
| Engine running after switch | Engine still connected to old context | Run `kurtosis engine restart` after switching contexts |