npm package: @oalacea/sneakpeek
Description: Unlock feature-flagged capabilities in Claude Code
Author: oalacea
Latest version: 1.6.20

# sneakpeek

Get a parallel build of Claude Code that unlocks feature-flagged capabilities like swarm mode.

Demo video of swarm mode in action: https://x.com/NicerInPerson/status/2014989679796347375

This installs a completely isolated instance of Claude Code—separate config, sessions, MCP servers, and credentials. Your existing Claude Code installation is untouched.

## Security

This project includes security-focused development practices:

- **Git hooks**: Pre-commit typecheck, lint, and format validation via [Lefthook](https://lefthook.dev)
- **Binary verification**: Validates copied binaries have proper shebangs before execution
- **Path validation**: Prevents path traversal attacks in variant directories
- **TOCTOU-safe**: Uses atomic directory creation without race conditions
- **No credential leaks**: API key placeholders are never written to shell profiles

## Install

```bash
npx @oalacea/sneakpeek quick --name claudesp
```

Add `~/.local/bin` to your PATH if not already (macOS/Linux):

```bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
```

Then run `claudesp` to launch.

### Windows

On Windows, wrappers are installed to `~/.claude-sneakpeek/bin/` by default. Add this directory to your PATH:

```powershell
# In PowerShell, add to user PATH (one-time)
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
$claudePath = "$env:USERPROFILE\.claude-sneakpeek\bin"
if ($userPath -notlike "*$claudePath*") {
  [Environment]::SetEnvironmentVariable("Path", "$userPath;$claudePath", "User")
}
```

Then restart your terminal and run:

```powershell
claudesp  # or claudesp.cmd
```

**Windows Shell Support:**
- **PowerShell** (5 or 7) - Fully supported for Z.ai environment setup
- **Git Bash** - Supported if installed
- **Command Prompt (cmd)** - Works but requires manual env var configuration

For Z.ai API key setup on PowerShell, the tool will automatically configure your PowerShell profile. If you prefer manual setup, add to your `$PROFILE`:

```powershell
# claude-sneakpeek: Z.ai env start
$env:Z_AI_API_KEY="your-key-here"
# claude-sneakpeek: Z.ai env end
```

## What gets unlocked?

Features that are built into Claude Code but not yet publicly released:

- **Swarm mode** — Native multi-agent orchestration with `TeammateTool`
- **Delegate mode** — Task tool can spawn background agents
- **Team coordination** — Teammate messaging and task ownership

## Commands

```bash
npx @oalacea/sneakpeek quick --name claudesp   # Install
npx @oalacea/sneakpeek update claudesp         # Update
npx @oalacea/sneakpeek remove claudesp         # Uninstall
```

## Where things live

```
~/.claude-sneakpeek/claudesp/
├── npm/           # Patched Claude Code
├── config/        # Isolated config, sessions, MCP servers
└── variant.json

~/.local/bin/claudesp   # Wrapper script (macOS/Linux)
~/.claude-sneakpeek/bin/claudesp.cmd   # Wrapper script (Windows)
```

## Alternative providers

Supports Z.ai, MiniMax, OpenRouter, and local models via cc-mirror. See [docs/providers.md](docs/providers.md).

## Development

```bash
npm install          # Install dependencies
npm run dev          # Run CLI from TypeScript sources
npm test             # Run all tests
npm run typecheck    # TypeScript check
npm run lint         # ESLint check
npm run format       # Prettier format
```

Git hooks are installed automatically on `npm install`. They run typecheck, lint, and format validation on every commit.

## Credits

Fork of [cc-mirror](https://github.com/numman-ali/cc-mirror) by Numman Ali.

## License

MIT