Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
124 commits
Select commit Hold shift + click to select a range
8f57f7f
some test scripts
starbaser Jul 31, 2025
fe92cc7
added tyro gitmcp
starbaser Jul 31, 2025
fa7d5e4
some prep for tyro
starbaser Jul 31, 2025
258a0a8
feat: implement Tyro-based CLI for ccproxy
starbaser Jul 31, 2025
4320bd5
tyro cli
starbaser Jul 31, 2025
90f2886
config changes
starbaser Jul 31, 2025
220a3ed
refactor: remove ConfigProvider class and fix pre-commit issues
starbaser Aug 1, 2025
b021d08
refactor: replace start/stop commands with litellm wrapper command
starbaser Aug 1, 2025
04f558e
fix: change LiteLLM class to Litellm to fix tyro command parsing
starbaser Aug 1, 2025
a832977
feat: add -d/--detach option to ccproxy litellm command
starbaser Aug 1, 2025
38a2631
feat: add ccproxy stop command to terminate background LiteLLM server
starbaser Aug 1, 2025
ab46dcc
feat: add ccproxy logs command with pager support
starbaser Aug 1, 2025
be07fcd
fix: handle timedelta objects in CCProxy handler duration calculations
starbaser Aug 1, 2025
c900a7d
yay
starbaser Aug 1, 2025
6d417ff
fix: resolve configuration loading in LiteLLM runtime environment
starbaser Aug 1, 2025
0c7fa72
oauth token working
starbaser Aug 1, 2025
c8312aa
feat: add robust OAuth token forwarding for Claude CLI requests
starbaser Aug 1, 2025
47a3be0
feat: add shell integration for automatic claude aliasing
starbaser Aug 1, 2025
72fb581
refactor: complete all TODO items in codebase
starbaser Aug 1, 2025
5a0ffc2
removed some generated project files that are no longer needed
starbaser Aug 1, 2025
f6f0b53
refactor: remove unused ccproxy_get_model function and fix label inco…
starbaser Aug 1, 2025
8d8e524
fix: use router fallback logic instead of hardcoded model
starbaser Aug 1, 2025
a58091f
fix: OAuth forwarding now based on routed model destination
starbaser Aug 1, 2025
ff4e4d1
refactor: extract request processing logic into modular hooks
starbaser Aug 2, 2025
b338d5a
refactor(classifier): remove unused code and make internal methods pr…
starbaser Aug 2, 2025
cb098ae
fix(security): prevent OAuth token exposure and improve error handling
starbaser Aug 2, 2025
01caad6
$(cat <<'EOF'
starbaser Aug 2, 2025
e1ffbd5
docs: improve configuration discovery clarity and predictability
starbaser Aug 2, 2025
3625348
test: improve token counting tests and remove obsolete files
starbaser Aug 2, 2025
1ec0431
prep for v1
starbaser Aug 2, 2025
b9fd9b7
chore(release): prepare v1.0.0 release
starbaser Aug 2, 2025
2cfa008
refactor(cli): rename 'litellm' command to 'start'
starbaser Aug 2, 2025
c7b2e87
Update README.md
starbaser Aug 2, 2025
ce545f3
Removed old claude files, updated readme
starbaser Aug 3, 2025
7986ad9
Merge branch 'main' of https://github.com/starbased-co/ccproxy
starbaser Aug 3, 2025
bb3ccd4
v1
starbaser Aug 3, 2025
cd9e0a9
removed workflow
starbaser Aug 3, 2025
41081b1
docs: clean up README for initial release
starbaser Aug 3, 2025
9efd605
docs: add acknowledgments section
starbaser Aug 3, 2025
6598fbe
docs(readme): highlight Claude MAX plan OAuth token integration
starbaser Aug 3, 2025
b31455d
docs(readme): add LiteLLM proxy features to MAX plan integration
starbaser Aug 3, 2025
08216fa
docs(readme): add LiteLLM proxy features to MAX plan integration
starbaser Aug 3, 2025
1d49dce
docs: update all references to use `ccproxy` with backticks
starbaser Aug 3, 2025
91c6bdd
Merge branch 'main' - resolved conflict keeping backticks
starbaser Aug 3, 2025
b9fcb03
title
starbaser Aug 3, 2025
b84e6b8
docs: update callback references and expand documentation
starbaser Aug 5, 2025
2886142
refactor: rename rule 'label' to 'name' for clarity
starbaser Aug 5, 2025
bac26cb
CLAUDE.md rewrite
starbaser Aug 7, 2025
a7970df
CLAUDE.md rewrite done
starbaser Aug 7, 2025
8737407
feat: add pre-commit hook to verify examples match templates
starbaser Aug 7, 2025
ddd8f1d
refactor: replace CCProxy with ccproxy in comments and strings
starbaser Aug 7, 2025
f9fd1e1
caching docs
starbaser Aug 7, 2025
0dd176c
feat: cherry-pick scripts directory from mitm branch
starbaser Aug 7, 2025
7a34ec8
feat(scripts): add Anthropic cache analyzer for Claude Code
starbaser Aug 7, 2025
ee07f59
fix(scripts): handle streaming responses in cache analyzer
starbaser Aug 7, 2025
9ce1828
fix(scripts): improve response handling in cache analyzer
starbaser Aug 7, 2025
1f7c9a3
refactor(hooks): rename hooks for clearer purpose
starbaser Aug 7, 2025
a2b989a
debug(cache_analyzer): add detailed logging to diagnose cache metrics
starbaser Aug 7, 2025
eec7113
testing cache analysis
starbaser Aug 7, 2025
e912015
fix(cache_analyzer): extract cache metrics from message_start event i…
starbaser Aug 7, 2025
1f9837f
feat(logging): add langfuse integration
starbaser Aug 15, 2025
c46aa72
feat(cli): hide shell integration command for future implementation
starbaser Aug 15, 2025
bd519f5
refactor: replace dataclasses with attrs throughout codebase
starbaser Aug 15, 2025
8031cf5
docs: replace outdated examples with comprehensive configuration guide
starbaser Aug 15, 2025
59b94c2
refactor: remove cache analyzer scripts from dev branch
starbaser Aug 15, 2025
1faea29
fixed model and routing bug
starbaser Aug 15, 2025
2f0f9d6
fixed typo using sonnet 3-5 and failing ooooooooooughhh
starbaser Aug 16, 2025
f1737f2
test: add claude command e2e integration tests
starbaser Aug 16, 2025
2abb2ef
docs: rewrite README focusing on Claude MAX subscription benefits
starbaser Aug 17, 2025
fbdd71c
renamed
starbaser Aug 17, 2025
8845010
feat(hooks): add default model passthrough mode
starbaser Aug 17, 2025
bb415aa
refactored some tests, added a diagram
starbaser Aug 17, 2025
f793745
wrapped logging lines
starbaser Aug 17, 2025
ad8b439
redid diagram
starbaser Aug 17, 2025
e231d9c
updated note
starbaser Aug 17, 2025
7814ad1
codeblocks
starbaser Aug 17, 2025
4b94d88
readme edits
starbaser Aug 17, 2025
def5f27
some output utils
starbaser Aug 17, 2025
508dd86
fix(templates): add config directory to sys.path for custom hook imports
starbaser Nov 10, 2025
56b24ee
Update README to streamline project notes
starbaser Nov 10, 2025
2c2c329
chore(templates): update to latest Claude model versions
starbaser Nov 10, 2025
e0d1037
feat(auth): add credentials loading and API key forwarding
starbaser Nov 11, 2025
f7772a0
docs: update configuration guide for credentials and hooks
starbaser Nov 11, 2025
498253f
docs: clarify API key vs OAuth usage in credentials
starbaser Nov 11, 2025
38ed56d
docs: correct OAuth vs API key authentication distinction
starbaser Nov 11, 2025
b11d766
docs: update model names to latest versions
starbaser Nov 11, 2025
7ef6df8
docs: update model references to Claude 4.5 versions
starbaser Nov 11, 2025
272824b
feat(cli): add JSON output flag to status command
starbaser Nov 18, 2025
116d181
feat(cli): auto-generate handler file on startup
starbaser Nov 19, 2025
661e4ac
docs: add installation and troubleshooting guides
starbaser Nov 19, 2025
f3156c4
docs: fix installation commands and prioritize PyPI
starbaser Nov 19, 2025
6f52af7
fix(cli): use bundled litellm from venv instead of PATH
starbaser Nov 19, 2025
11b2548
discord link
starbaser Nov 29, 2025
b042303
feat(auth): add custom user-agent support per OAuth token
starbaser Nov 30, 2025
747ab19
chore: update Opus model references to 4.5
starbaser Nov 30, 2025
0dc01f3
feat(hooks): add capture_headers hook and forward_oauth improvements
starbaser Nov 30, 2025
3f24e42
chore: update ccproxy.yaml template to current format
starbaser Nov 30, 2025
c103c50
feat(hooks): add parameter support and enhance status display
starbaser Dec 1, 2025
17f4e41
feat(cli): auto-insert -- separator for run command arguments
starbaser Dec 2, 2025
ebd7fa7
test: remove obsolete OAuth tests for new oat_sources API
starbaser Dec 2, 2025
2a3272f
test: add comprehensive tests for capture_headers hook
starbaser Dec 2, 2025
ee711db
feat(hooks): capture HTTP headers as LangFuse trace metadata
starbaser Dec 3, 2025
abac7d1
feat(hooks): extract session ID from Claude Code user_id for LangFuse
starbaser Dec 3, 2025
bb9aa34
feat(cli): preserve custom handler files on startup
starbaser Dec 6, 2025
f9f96c5
chore: bump version to 1.2.0
starbaser Dec 6, 2025
b1ac10f
feat(cli): add url field to status JSON output
starbaser Dec 7, 2025
2c0c611
fix(handler): skip custom routing for LiteLLM health checks
starbaser Dec 7, 2025
0aa46cb
docs: add python-extended standards import to CLAUDE.md
starbaser Dec 9, 2025
48c4150
docs: clarify project naming convention in CLAUDE.md
starbaser Dec 9, 2025
39341ae
docs: simplify README header and Discord link
starbaser Dec 9, 2025
c1c8763
chore: merge gitignore updates from feature branches
starbaser Dec 9, 2025
45f5536
docs: update README with new features and editable dev setup
starbaser Dec 10, 2025
3d4faa5
docs: add request lifecycle diagram and hook params documentation
starbaser Dec 12, 2025
6a18ad0
feat(hooks): add beta headers hook for Claude Max OAuth support
starbaser Dec 20, 2025
d7e3847
docs: rewrite README intro to focus on development platform
starbaser Jan 21, 2026
3e037b8
Update README.md
starbaser Feb 1, 2026
4d977b3
Update README.md
starbaser Feb 1, 2026
7825324
Update README.md
starbaser Feb 6, 2026
26811bd
Update README.md
starbaser Feb 6, 2026
781e029
oops
starbaser Feb 7, 2026
8fbad2e
Merge branch 'main' of github.com:starbaser/ccproxy
starbaser Feb 7, 2026
5a10987
feat: add claude-opus-4-6 to model config
Feb 8, 2026
565ee42
Merge pull request #11 from npinto/add-opus-4-6
starbaser Feb 8, 2026
8443d2e
fix: pass num_workers from ccproxy.yaml to litellm CLI
npinto Feb 13, 2026
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
50 changes: 50 additions & 0 deletions .claude/AGENTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
# ccproxy Agent Documentation

## Database Query Commands

### Quick Reference

```bash
# Basic query
ccproxy db sql "SELECT COUNT(*) FROM \"CCProxy_HttpTraces\""

# From file
ccproxy db sql --file query.sql

# Output formats
ccproxy db sql "SELECT * FROM \"CCProxy_HttpTraces\" LIMIT 10" --json
ccproxy db sql "SELECT * FROM \"CCProxy_HttpTraces\" LIMIT 10" --csv
```

### Key Table: `CCProxy_HttpTraces`

**Important Fields:**
- `proxy_direction` - 0=reverse (client→LiteLLM), 1=forward (LiteLLM→provider)
- `session_id` - Links related requests across proxy layers (extracted from `metadata.user_id`)
- `method`, `url`, `request_headers`, `response_headers`
- `request_body`, `response_body` - HTTP payload content
- `timestamp` - Request timestamp

**Common Queries:**

```sql
-- Filter by session
SELECT * FROM "CCProxy_HttpTraces" WHERE session_id = 'abc123';

-- Reverse proxy traffic only
SELECT * FROM "CCProxy_HttpTraces" WHERE proxy_direction = 0;

-- Forward proxy traffic only
SELECT * FROM "CCProxy_HttpTraces" WHERE proxy_direction = 1;

-- Recent traces with body content
SELECT timestamp, method, url, request_body
FROM "CCProxy_HttpTraces"
ORDER BY timestamp DESC
LIMIT 20;
```

**Database Connection:**
- Set via `CCPROXY_DATABASE_URL` environment variable
- Or configure in `ccproxy.yaml` under `litellm.environment`
- Current: `postgresql://ccproxy:test@localhost:5432/ccproxy_mitm`
147 changes: 0 additions & 147 deletions .claude/TM_COMMANDS_GUIDE.md

This file was deleted.

Loading