Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 0 additions & 28 deletions .claude-plugin/marketplace.json

This file was deleted.

22 changes: 2 additions & 20 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -20,17 +20,10 @@ jobs:
bash -n tests/test_cc_launcher.sh
bash -n tests/test_install.sh
bash -n tests/fixtures/mock_claude
bash -n devcontainer-features/src/claude-code/install.sh
bash -n scripts/detect-auth.sh

- name: ShellCheck
run: shellcheck cc-launcher install.sh tests/run_tests.sh tests/test_cc_launcher.sh tests/test_install.sh tests/fixtures/mock_claude devcontainer-features/src/claude-code/install.sh

- name: Validate feature JSON
run: jq . devcontainer-features/src/claude-code/devcontainer-feature.json

- name: Validate template JSON
run: |
jq . devcontainer-templates/src/devcontainer/devcontainer-template.json
run: shellcheck cc-launcher install.sh tests/run_tests.sh tests/test_cc_launcher.sh tests/test_install.sh tests/fixtures/mock_claude scripts/detect-auth.sh

test:
runs-on: ubuntu-latest
Expand All @@ -39,14 +32,3 @@ jobs:

- name: Run tests
run: bash tests/run_tests.sh

test-features:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4

- name: Install devcontainer CLI
run: npm install -g @devcontainers/cli

- name: Test claude-code feature
run: devcontainer features test -f claude-code -p devcontainer-features
35 changes: 0 additions & 35 deletions .github/workflows/publish-devcontainers.yml

This file was deleted.

1 change: 0 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
@@ -1,4 +1,3 @@
.claude/settings.local.json
.env
.DS_Store
.worktrees/
4 changes: 3 additions & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,14 @@
# Development Guidelines

1. Run shellcheck on any shell script before committing
2. Use devcontainer to test the install script and other components
2. Test with `bash tests/run_tests.sh`; container-based testing of the install script runs in CI or on a Docker-capable host
3. Don't install scripts locally - it may cause unforeseen issues
4. Use `$'...'` syntax for ANSI color codes (e.g., `C_RED=$'\033[31m'`)

## Devcontainer Commands

Note: requires a Docker-capable host.

```bash
# Start devcontainer (reuses existing if available)
devcontainer up --workspace-folder .
Expand Down
57 changes: 10 additions & 47 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,9 @@
# cc-kit

A toolkit and plugin marketplace for Claude Code. Some components are installable plugins (via `claude plugin install`), others are standalone scripts or config files installed via curl.

## Plugin Marketplace

cc-kit doubles as a [Claude Code plugin marketplace](https://docs.anthropic.com/en/docs/claude-code/plugins). Plugins provide slash-command skills that run inside Claude Code. Not everything in cc-kit is a plugin — cc-launcher and cc-headless are standalone and installed separately.

```bash
# Add the marketplace
claude plugin marketplace add https://github.com/Gnnng/cc-kit

# Install a plugin
claude plugin install cc-devcontainer
```

### Available Plugins

| Plugin | Description |
|--------|-------------|
| `cc-devcontainer` | Devcontainer setup with Claude Code authentication for headless agents |
A toolkit for Claude Code — standalone scripts and config files installed via curl.

## Installation

### Standalone components (curl)

cc-launcher and cc-headless are not plugins — install them with the install script:

```bash
# Install cc-launcher
curl -fsSL https://raw.githubusercontent.com/Gnnng/cc-kit/main/install.sh | bash -s cc-launcher
Expand All @@ -34,15 +12,6 @@ curl -fsSL https://raw.githubusercontent.com/Gnnng/cc-kit/main/install.sh | bash
curl -fsSL https://raw.githubusercontent.com/Gnnng/cc-kit/main/install.sh | bash -s cc-headless
```

### Plugins

Plugins can be installed via the marketplace (see above) or with the install script:

```bash
# Install cc-devcontainer plugin
curl -fsSL https://raw.githubusercontent.com/Gnnng/cc-kit/main/install.sh | bash -s cc-devcontainer
```

### Options

```bash
Expand All @@ -65,7 +34,7 @@ See component-specific sections below for manual installation steps.
|-----------|------|-------------|
| [cc-launcher](#cc-launcher) | Standalone script | Multi-provider launcher - switch between Anthropic and alternative backends |
| [cc-headless](#cc-headless) | Config files | Configuration for headless/API-only Claude Code sessions |
| [cc-devcontainer](#cc-devcontainer) | Plugin | Devcontainer setup and troubleshooting with auth detection |
| [detect-auth](#detect-auth) | Utility script | Detect Claude Code credentials and export them as env vars |

---

Expand Down Expand Up @@ -160,27 +129,21 @@ See [cc-headless/README.md](cc-headless/README.md) for more details.

---

## cc-devcontainer

Plugin for initializing and troubleshooting devcontainers with Claude Code authentication. Provides two skills: `/devcontainer-init` and `/devcontainer-troubleshoot`.

### Authentication Detection
## detect-auth

The plugin automatically detects your Claude Code credentials (in priority order):
[`scripts/detect-auth.sh`](scripts/detect-auth.sh) detects your Claude Code credentials and outputs them as env vars — useful for passing auth into VMs or containers. Checks in priority order:

1. **OAuth token** (`CLAUDE_CODE_OAUTH_TOKEN`) — env var, then platform storage (macOS Keychain or `~/.claude/.credentials.json` on Linux)
2. **Enterprise token** (`ANTHROPIC_AUTH_TOKEN`) — env var
3. **API key** (`ANTHROPIC_API_KEY`) — env var

Detected credentials are written to `.devcontainer/.env` and passed into the container automatically.

### Skills

**`/devcontainer-init`** — Scaffolds a `.devcontainer/` directory with Dockerfile, devcontainer.json, and an `.env` file containing your detected auth credentials. Optionally accepts `--name <container-name>`.

**`/devcontainer-troubleshoot`** — Diagnoses auth and container issues. Checks host credentials, `.env` configuration, container environment, and Claude CLI availability. Run with `auth`, `container`, or `all`.
```bash
# Print detected credentials to stdout
./scripts/detect-auth.sh

See [cc-devcontainer/skills/devcontainer-init/SKILL.md](cc-devcontainer/skills/devcontainer-init/SKILL.md) and [cc-devcontainer/skills/devcontainer-troubleshoot/SKILL.md](cc-devcontainer/skills/devcontainer-troubleshoot/SKILL.md) for full details.
# Write them to an env file
./scripts/detect-auth.sh --env-file .env
```

---

Expand Down
9 changes: 0 additions & 9 deletions cc-devcontainer/.claude-plugin/plugin.json

This file was deleted.

91 changes: 0 additions & 91 deletions cc-devcontainer/skills/devcontainer-init/SKILL.md

This file was deleted.

This file was deleted.

Loading
Loading