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
38 changes: 22 additions & 16 deletions .github/maintainer/context.md
Original file line number Diff line number Diff line change
@@ -1,33 +1,39 @@
# Project Context

## Vision
[One paragraph: what is this project and why does it exist?]

cc-mirror provides isolated Claude Code variants that connect to multiple AI providers. The goal is fast, reliable provider switching with consistent UX, clear configuration, and minimal breakage across upstream Claude Code updates.

## Current Priorities
1. [Top priority]
2. [Second priority]
3. [Third priority]

1. Expand provider coverage with verified auth/base URLs and minimal UX friction.
2. Keep core flows stable across Claude Code updates (minimax/zai compatibility).
3. Improve documentation for config layout, wrapper usage, and MCP server setup.

## Success Metrics
- [Adoption goal or usage signal]
- [Quality goal: reliability, docs, tests, etc.]

- Adoption: increasing provider variants created per release.
- Quality: fewer crash/blocker bugs and reduced support churn.

## Areas

| Area | Status | Notes |
|------|--------|-------|
| `src/core/` | Stable | High scrutiny for changes |
| `src/cli/` | Active | Moderate churn okay |
| `docs/` | Needs work | Contributions welcome |
| Area | Status | Notes |
| ----------- | ---------- | -------------------------------------- |
| `src/core/` | Stable | High scrutiny for changes |
| `src/cli/` | Active | Moderate churn okay |
| `src/tui/` | Active | UX changes welcome |
| `docs/` | Needs work | Prioritize config + onboarding clarity |

## Contribution Guidelines
- [Key guideline 1]
- [Key guideline 2]

- External PRs are reference implementations; maintainer implements changes directly.
- Provide a test plan and verified provider documentation links for provider PRs.

## Tone
[How should responses sound? Formal? Casual? Technical?]

Friendly, direct, and technical. No vague promises.

## Out of Scope
- [Thing we explicitly don't want]
- [Another thing]

- Team mode (removed in latest releases; only supported in 1.6.3).
- Merging external PRs directly.
30 changes: 15 additions & 15 deletions .github/maintainer/contributors.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,21 @@
# Contributor Notes

## Active Contributors
## Jan 2026 Snapshot (open items)

### @username
- **First seen:** 2025-12-15
- **Contributions:** 3 PRs (2 implemented), 5 issues
- **Strengths:** Good tests, clear descriptions
- **Notes:** Offered to help maintain. Responsive.
### PR Authors

### @another-user
- **First seen:** 2026-01-10
- **Contributions:** 1 PR (pending)
- **Notes:** First-time contributor. Needs guidance on tests.
- @MohMaya (PR:9) — Sync Variants feature proposal; good direction but currently deferred.
- @vdimarco (PR:4) — GatewayZ provider; likely superseded by PR:31 (credit when closing).
- @0xGingi (PR:5) — NanoGPT provider; likely superseded by PR:31 (credit when closing).
- @jerilynzheng (PR:21) — Vercel AI Gateway provider; likely superseded by PR:31 (credit when closing).
- @mikekelly (PR:22) — `--no-skills` flag request; decision is “no flag, default off” (close with explanation).
- @am-will (PR:20) — ccstatusline integration idea; needs product decision and UX fit check.

## Former Contributors

### @past-contributor
- **Active:** 2025-06 to 2025-09
- **Notes:** Great work on CLI. Moved on to other projects.
### Issue Reporters / Feedback

- @Set27 (ISSUE:27) — minimax crash report with stack trace; needs repro details/version confirmation.
- @netman2048 (ISSUE:29) — /compact failure with good environment details; likely upstream behavior.
- @Jobierre (ISSUE:14) — IPv6 TLS issue with a working workaround; good troubleshooting write-up.
- @husseinkaraki (ISSUE:12, ISSUE:16) — Termux + MCP server UX feedback; strong doc improvement signal.
- @acomarcho (ISSUE:23) — cloud provider request (Azure Foundry example env vars); good potential provider template.
- @seramat (ISSUE:10) — Z.ai Chinese endpoint request with base URL suggestion.
32 changes: 32 additions & 0 deletions .github/maintainer/decisions.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,17 +3,49 @@
## 2026-01

### [ISSUE:42] Deferred - Version requirements

**Date:** 2026-01-15
**Decision:** Defer to post-1.0
**Reasoning:** Good feature but adds complexity. Want to stabilize core first.

### [PR:38] Closed - Implemented fix

**Date:** 2026-01-16
**Decision:** Closed after maintainer implementation
**Reasoning:** Fixes critical bug affecting all Windows users. Tests pass.

### [ISSUE:30] Closed - Stale

**Date:** 2026-01-16
**Decision:** Closed without action
**Reasoning:** No response to info request for 60 days.

### Team mode removal in current releases

**Date:** 2026-01-18
**Decision:** Team mode is out of scope for current releases (only supported in 1.6.3).
**Reasoning:** Maintenance cost outweighs value; focus on provider expansion and stability.

### [ISSUE:8] Deferred - Sync Variants

**Date:** 2026-01-18
**Decision:** Defer Sync Variants to a later milestone.
**Reasoning:** High complexity; prioritize provider expansion and core stability first.

### [PR:22] Declined - --no-skills flag

**Date:** 2026-01-18
**Decision:** Do not add a dedicated flag; dev-browser defaults to off with opt-in.
**Reasoning:** Team mode removed; simpler default and UI toggle avoids extra CLI surface area.

### Ollama provider intake

**Date:** 2026-01-18
**Decision:** Add Ollama provider (Anthropic compatibility; local + cloud).
**Reasoning:** Local-first demand and clear compatibility docs make this a high-leverage addition.

### Gateway provider PR consolidation (PR:31)

**Date:** 2026-01-23
**Decision:** Consolidate gateway provider work into PR:31; close PR:4 / PR:5 / PR:21 as duplicates after merge (with credit).
**Reasoning:** Multiple overlapping provider PRs increase drift risk. One canonical implementation keeps auth/env semantics consistent and centralizes tests + docs.
135 changes: 52 additions & 83 deletions .github/maintainer/index/graph.json
Original file line number Diff line number Diff line change
@@ -1,18 +1,11 @@
{
"generatedAt": "2026-01-17T22:52:03.295Z",
"generatedAt": "2026-01-23T13:29:59.600Z",
"nodes": [
{
"id": "issue:7",
"type": "issue",
"title": "[Bug] installation on Windows fails",
"priorityScore": 49,
"actionability": "ready"
},
{
"id": "issue:27",
"type": "issue",
"title": "[Bug] EJ.has is not a function",
"priorityScore": 19,
"priorityScore": 31,
"actionability": "needs-info"
},
{
Expand All @@ -22,6 +15,13 @@
"priorityScore": 13,
"actionability": "ready"
},
{
"id": "issue:29",
"type": "issue",
"title": "[Bug] Unable to compact",
"priorityScore": 12,
"actionability": "needs-info"
},
{
"id": "issue:14",
"type": "issue",
Expand All @@ -43,13 +43,6 @@
"priorityScore": 11,
"actionability": "ready"
},
{
"id": "issue:29",
"type": "issue",
"title": "[Bug] Unable to compact",
"priorityScore": 10,
"actionability": "needs-info"
},
{
"id": "issue:24",
"type": "issue",
Expand Down Expand Up @@ -78,133 +71,114 @@
"priorityScore": 5,
"actionability": "ready"
},
{
"id": "pr:26",
"type": "pr",
"title": "Claude Code 2.1.7 alignment: retire team mode for now",
"priorityScore": 32,
"implementationScore": 4,
"actionability": "needs-analysis"
},
{
"id": "pr:11",
"type": "pr",
"title": "feat: add Windows compatibility",
"priorityScore": 21,
"implementationScore": 32,
"actionability": "needs-analysis"
},
{
"id": "pr:9",
"type": "pr",
"title": "feat: add Sync Variants feature to copy config between variants",
"priorityScore": 21,
"implementationScore": 26,
"priorityScore": 16,
"implementationScore": 29,
"actionability": "needs-analysis"
},
{
"id": "pr:4",
"type": "pr",
"title": "feat: add GatewayZ provider with Anthropic API support",
"priorityScore": 8,
"implementationScore": 9,
"priorityScore": 12,
"implementationScore": 16,
"actionability": "needs-analysis"
},
{
"id": "pr:5",
"id": "pr:31",
"type": "pr",
"title": "feat: add NanoGPT as a provider",
"priorityScore": 6,
"implementationScore": 0,
"title": "Add gateway providers and default dev-browser off",
"priorityScore": 12,
"implementationScore": 3,
"actionability": "needs-analysis"
},
{
"id": "pr:30",
"id": "pr:5",
"type": "pr",
"title": "fix: update Claude Code to 2.1.7 with Windows support",
"priorityScore": 0,
"implementationScore": 48,
"title": "feat: add NanoGPT as a provider",
"priorityScore": 6,
"implementationScore": 1,
"actionability": "needs-analysis"
},
{
"id": "pr:22",
"type": "pr",
"title": "feat: add --no-skills flag to skip bundled skill installation",
"priorityScore": 0,
"implementationScore": 0,
"implementationScore": 11,
"actionability": "needs-analysis"
},
{
"id": "pr:21",
"type": "pr",
"title": "feat: add Vercel AI Gateway provider",
"priorityScore": 0,
"implementationScore": 0,
"implementationScore": 2,
"actionability": "needs-analysis"
},
{
"id": "pr:20",
"type": "pr",
"title": "feat: Integrate ccstatusline as a top-level menu option",
"priorityScore": 0,
"implementationScore": 0,
"actionability": "needs-analysis"
},
{
"id": "pr:17",
"type": "pr",
"title": "feat: add Windows splash screen support for all providers",
"priorityScore": 0,
"implementationScore": 9,
"implementationScore": 2,
"actionability": "needs-analysis"
}
],
"edges": [
{
"from": "issue:7",
"to": "issue:26",
"from": "issue:27",
"to": "issue:28",
"type": "mentions"
},
{
"from": "issue:7",
"to": "issue:30",
"type": "mentions"
"from": "issue:9",
"to": "issue:8",
"type": "mentioned_by"
},
{
"from": "issue:30",
"to": "issue:7",
"from": "issue:31",
"to": "issue:23",
"type": "mentioned_by"
},
{
"from": "issue:27",
"to": "issue:28",
"from": "pr:9",
"to": "issue:8",
"type": "mentions"
},
{
"from": "issue:9",
"to": "issue:8",
"from": "issue:31",
"to": "pr:4",
"type": "mentioned_by"
},
{
"from": "pr:26",
"to": "issue:1",
"from": "pr:31",
"to": "issue:23",
"type": "mentions"
},
{
"from": "issue:7",
"to": "pr:26",
"type": "mentioned_by"
"from": "pr:31",
"to": "issue:4",
"type": "mentions"
},
{
"from": "pr:11",
"to": "pr:17",
"type": "possible_duplicate"
"from": "pr:31",
"to": "issue:21",
"type": "mentions"
},
{
"from": "pr:9",
"to": "issue:8",
"from": "pr:31",
"to": "issue:5",
"type": "mentions"
},
{
"from": "issue:31",
"to": "pr:5",
"type": "mentioned_by"
},
{
"from": "pr:5",
"to": "pr:4",
Expand All @@ -216,13 +190,8 @@
"type": "possible_duplicate"
},
{
"from": "pr:30",
"to": "issue:7",
"type": "mentions"
},
{
"from": "issue:7",
"to": "pr:30",
"from": "issue:31",
"to": "pr:21",
"type": "mentioned_by"
}
]
Expand Down
Loading
Loading