commit 8ce8bf72f71c5ea0add5de1fb6e336aaf84e2414 Author: WildDragon Deploy Date: Wed May 27 22:45:26 2026 -0400 chore: fork from siteboon/claudecodeui with Forgejo integration diff --git a/.env.example b/.env.example new file mode 100755 index 0000000..7e1d124 --- /dev/null +++ b/.env.example @@ -0,0 +1,45 @@ +# CloudCLI UI Environment Configuration +# Only includes variables that are actually used in the code +# +# TIP: Run 'cloudcli status' to see where this file should be located +# and to view your current configuration. +# +# Available CLI commands: +# claude-code-ui - Start the server (default) +# cloudcli start - Start the server +# cloudcli status - Show configuration and data locations +# cloudcli help - Show help information +# cloudcli version - Show version information + +# ============================================================================= +# SERVER CONFIGURATION +# ============================================================================= + +# Backend server port (Express API + WebSocket server) +#API server +SERVER_PORT=3001 +#Frontend port +VITE_PORT=5173 + +# Host/IP to bind servers to (default: 0.0.0.0 for all interfaces) +# Use 127.0.0.1 to restrict to localhost only +HOST=0.0.0.0 + +# Uncomment the following line if you have a custom claude cli path other than the default "claude" +# CLAUDE_CLI_PATH=claude + +# ============================================================================= +# DATABASE CONFIGURATION +# ============================================================================= + +# Path to the authentication database file +# This is where user credentials, API keys, and tokens are stored. +# +# To use a custom location: +# DATABASE_PATH=/path/to/your/custom/auth.db +# +# Claude Code context window size (maximum tokens per session) +VITE_CONTEXT_WINDOW=160000 +CONTEXT_WINDOW=160000 + + diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md new file mode 100644 index 0000000..9eb7c6e --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -0,0 +1,41 @@ +--- +name: Bug report +about: Create a report to help us improve +title: '' +labels: '' +assignees: '' +type: Bug + +--- + +**Describe the bug** +A clear and concise description of what the bug is. + +**To Reproduce** +Steps to reproduce the behavior: +1. Go to '...' +2. Click on '....' +3. Scroll down to '....' +4. See error + +**Expected behavior** +A clear and concise description of what you expected to happen. + +**Screenshots** +If applicable, add screenshots to help explain your problem. + +**Error message** +If applicable, add the error message you see to help explain your problem. + +**Desktop (please complete the following information):** + - OS: [e.g. iOS] + - Browser [e.g. chrome, safari] + - Version [e.g. 22] + +**Smartphone (please complete the following information):** + - Device: [e.g. iPhone6] + - OS: [e.g. iOS8.1] + - Browser [e.g. stock browser, safari] + +**Additional context** +Add any other context about the problem here. diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md new file mode 100644 index 0000000..712801b --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.md @@ -0,0 +1,19 @@ +--- +name: Feature request +about: Suggest an idea for this project +title: "[Feature]" +labels: '' +assignees: '' +type: Feature + +--- + +**Is your feature request related to a problem? Please describe.** +A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] + +**Describe the solution you'd like** +A clear and concise description of what you want to happen. + + +**Additional context** +Add any other context or screenshots about the feature request here. diff --git a/.github/workflows/discord-release.yml b/.github/workflows/discord-release.yml new file mode 100644 index 0000000..2a11f2c --- /dev/null +++ b/.github/workflows/discord-release.yml @@ -0,0 +1,22 @@ +name: Discord Release Notification + +on: + release: + types: [published] + +jobs: + github-releases-to-discord: + runs-on: ubuntu-latest + steps: + - name: Checkout + uses: actions/checkout@v3 + - name: Github Releases To Discord + uses: SethCohen/github-releases-to-discord@v1.19.0 + with: + webhook_url: ${{ secrets.DISCORD_WEBHOOK_URL }} + color: "2105893" + username: "Release Changelog" + avatar_url: "https://cdn.discordapp.com/avatars/487431320314576937/bd64361e4ba6313d561d54e78c9e7171.png" + content: "||@everyone||" + footer_title: "Changelog" + reduce_headings: true diff --git a/.github/workflows/docker.yml b/.github/workflows/docker.yml new file mode 100644 index 0000000..9285619 --- /dev/null +++ b/.github/workflows/docker.yml @@ -0,0 +1,51 @@ +name: Docker + +on: + workflow_dispatch: + inputs: + extra_tag: + description: 'Additional tag to push alongside the template tag (e.g. v1.2.3, leave empty for none)' + required: false + type: string + +jobs: + build: + runs-on: ubuntu-latest + strategy: + fail-fast: false + matrix: + template: [claude-code, codex, gemini] + steps: + - uses: actions/checkout@v6 + + - name: Set up QEMU + uses: docker/setup-qemu-action@v3 + + - name: Set up Docker Buildx + uses: docker/setup-buildx-action@v3 + + - name: Log in to Docker Hub + uses: docker/login-action@v3 + with: + username: ${{ secrets.DOCKERHUB_USERNAME }} + password: ${{ secrets.DOCKERHUB_TOKEN }} + + - name: Compute tags + id: tags + run: | + TAGS="docker.io/cloudcliai/sandbox:${{ matrix.template }}" + if [ -n "${{ inputs.extra_tag }}" ]; then + TAGS="$TAGS,docker.io/cloudcliai/sandbox:${{ matrix.template }}-${{ inputs.extra_tag }}" + fi + echo "tags=$TAGS" >> "$GITHUB_OUTPUT" + + - name: Build and push + uses: docker/build-push-action@v6 + with: + context: ./docker + file: ./docker/${{ matrix.template }}/Dockerfile + platforms: linux/amd64,linux/arm64 + push: true + tags: ${{ steps.tags.outputs.tags }} + cache-from: type=gha,scope=${{ matrix.template }} + cache-to: type=gha,mode=max,scope=${{ matrix.template }} diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml new file mode 100644 index 0000000..29cddae --- /dev/null +++ b/.github/workflows/release.yml @@ -0,0 +1,50 @@ +name: Release + +on: + workflow_dispatch: + inputs: + increment: + description: 'Version bump: patch, minor, major, or explicit (e.g. 1.27.0)' + required: true + default: 'patch' + type: string + release_name: + description: 'Custom release name (optional, defaults to "CloudCLI UI vX.Y.Z")' + required: false + type: string + +jobs: + release: + runs-on: ubuntu-latest + permissions: + contents: write + id-token: write + steps: + - uses: actions/checkout@v6 + with: + fetch-depth: 0 + token: ${{ secrets.RELEASE_PAT }} + + - uses: actions/setup-node@v6 + with: + node-version: 22 + registry-url: https://registry.npmjs.org + + - name: git config + run: | + git config user.name "${GITHUB_ACTOR}" + git config user.email "${GITHUB_ACTOR}@users.noreply.github.com" + + - run: npm ci + + - name: Release + run: | + ARGS="--ci --increment=${{ inputs.increment }}" + if [ -n "${{ inputs.release_name }}" ]; then + ARGS="$ARGS --github.releaseName=\"${{ inputs.release_name }}\"" + fi + npx release-it $ARGS + env: + GITHUB_TOKEN: ${{ secrets.RELEASE_PAT }} + NPM_TOKEN: ${{ secrets.NPM_TOKEN }} + NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} diff --git a/.gitignore b/.gitignore new file mode 100755 index 0000000..e6b7985 --- /dev/null +++ b/.gitignore @@ -0,0 +1,144 @@ +# Dependencies +node_modules/ +npm-debug.log* +yarn-debug.log* +yarn-error.log* +pnpm-debug.log* +lerna-debug.log* + +# Build outputs +dist/ +dist-server/ +dist-ssr/ +build/ +out/ + +# Environment variables +.env +.env.local +.env.development.local +.env.test.local +.env.production.local + +# IDE and editor files +.vscode/ +.idea/ +*.swp +*.swo +*~ + +# OS generated files +.DS_Store +.DS_Store? +._* +.Spotlight-V100 +.Trashes +ehthumbs.db +Thumbs.db + +# Logs +*.log +logs/ + +# Runtime data +pids +*.pid +*.seed +*.pid.lock + +# Coverage directory used by tools like istanbul +coverage/ +*.lcov + +# nyc test coverage +.nyc_output + +# Dependency directories +jspm_packages/ + +# Optional npm cache directory +.npm + +# Optional eslint cache +.eslintcache + +# Optional REPL history +.node_repl_history + +# Output of 'npm pack' +*.tgz + +# Yarn Integrity file +.yarn-integrity + +# dotenv environment variables file +.env.test + +# parcel-bundler cache (https://parceljs.org/) +.cache +.parcel-cache + +# Next.js build output +.next + +# Nuxt.js build / generate output +.nuxt + +# Storybook build outputs +.out +.storybook-out + +# Temporary folders +tmp/ +temp/ +.tmp/ + +# Vite +.vite/ + +# Local Netlify folder +.netlify + +# AI specific +.claude/ +.cursor/ +.roo/ +.taskmaster/ +.cline/ +.windsurf/ +.serena/ +CLAUDE.md +.mcp.json +.gemini/ + +# Database files +*.db +*.sqlite +*.sqlite3 + +logs +dev-debug.log +# Editor directories and files +.idea +.vscode +*.suo +*.ntvs* +*.njsproj +*.sln +*.sw? +# OS specific + +# Task files +tasks.json +tasks/ + +# Translations +!src/i18n/locales/en/tasks.json +!src/i18n/locales/ja/tasks.json +!src/i18n/locales/ru/tasks.json +!src/i18n/locales/de/tasks.json +!src/i18n/locales/tr/tasks.json +!src/i18n/locales/it/tasks.json + +# Git worktrees +.worktrees/ diff --git a/.gitmodules b/.gitmodules new file mode 100644 index 0000000..ca83e73 --- /dev/null +++ b/.gitmodules @@ -0,0 +1,3 @@ +[submodule "plugins/starter"] + path = plugins/starter + url = https://github.com/cloudcli-ai/cloudcli-plugin-starter.git diff --git a/.husky/commit-msg b/.husky/commit-msg new file mode 100644 index 0000000..a78cc75 --- /dev/null +++ b/.husky/commit-msg @@ -0,0 +1 @@ +npx commitlint --edit $1 diff --git a/.husky/pre-commit b/.husky/pre-commit new file mode 100644 index 0000000..2312dc5 --- /dev/null +++ b/.husky/pre-commit @@ -0,0 +1 @@ +npx lint-staged diff --git a/.npmignore b/.npmignore new file mode 100644 index 0000000..b7d6c30 --- /dev/null +++ b/.npmignore @@ -0,0 +1,57 @@ + +*.md +!README.md +.env* +.gitignore +.nvmrc +.release-it.json +release.sh +postcss.config.js +vite.config.js +tailwind.config.js + +# Database files +authdb/ +*.db +*.sqlite +*.sqlite3 + + +# IDE and editor files +.vscode/ +.idea/ +*.swp +*.swo +*~ + +# OS generated files +.DS_Store +.DS_Store? +._* +.Spotlight-V100 +.Trashes +ehthumbs.db +Thumbs.db + +# AI specific +.claude/ +.cursor/ +.roo/ +.taskmaster/ +.cline/ +.windsurf/ +.serena/ +CLAUDE.md +.mcp.json + + +# Task files +tasks.json +tasks/ + +# Environment variables +.env +.env.local +.env.development.local +.env.test.local +.env.production.local diff --git a/.nvmrc b/.nvmrc new file mode 100644 index 0000000..92f279e --- /dev/null +++ b/.nvmrc @@ -0,0 +1 @@ +v22 \ No newline at end of file diff --git a/.release-it.json b/.release-it.json new file mode 100644 index 0000000..0d2a0f8 --- /dev/null +++ b/.release-it.json @@ -0,0 +1,41 @@ +{ + "git": { + "commitMessage": "chore(release): v${version}", + "tagName": "v${version}", + "requireBranch": "main", + "requireCleanWorkingDir": true + }, + "npm": { + "publish": true, + "publishArgs": ["--access public"] + }, + "github": { + "release": true, + "releaseName": "CloudCLI UI v${version}" + }, + "hooks": { + "before:init": ["npm run build"] + }, + "plugins": { + "@release-it/conventional-changelog": { + "infile": "CHANGELOG.md", + "header": "# Changelog\n\nAll notable changes to CloudCLI UI will be documented in this file.\n", + "preset": { + "name": "conventionalcommits", + "types": [ + { "type": "feat", "section": "New Features" }, + { "type": "feature", "section": "New Features" }, + { "type": "fix", "section": "Bug Fixes" }, + { "type": "perf", "section": "Performance" }, + { "type": "refactor", "section": "Refactoring" }, + { "type": "docs", "section": "Documentation" }, + { "type": "style", "section": "Styling" }, + { "type": "chore", "section": "Maintenance" }, + { "type": "ci", "section": "CI/CD" }, + { "type": "test", "section": "Tests" }, + { "type": "build", "section": "Build" } + ] + } + } + } +} diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..075cd61 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,332 @@ +# Changelog + +All notable changes to CloudCLI UI will be documented in this file. + + +## [1.32.0](https://github.com/siteboon/claudecodeui/compare/v1.31.5...v1.32.0) (2026-05-13) + +### Bug Fixes + +* add clarification on auto mode ([392c73b](https://github.com/siteboon/claudecodeui/commit/392c73b6933600ea8a589c5d4eff5f7b830f99c5)) +* enhance regex to correctly parse wrapper file paths for claude.exe ([#741](https://github.com/siteboon/claudecodeui/issues/741)) ([beb0a50](https://github.com/siteboon/claudecodeui/commit/beb0a50413beddfb16f6b49103e1b6b80567cb90)) + +## [1.31.5](https://github.com/siteboon/claudecodeui/compare/v1.31.4...v1.31.5) (2026-04-30) + +### New Features + +* add auto mode to claude code ([3f71d49](https://github.com/siteboon/claudecodeui/commit/3f71d4932b05dfedcdf816e2a3d7d0cd69c4f566)) + +## [1.31.4](https://github.com/siteboon/claudecodeui/compare/v1.31.3...v1.31.4) (2026-04-30) + +### Bug Fixes + +* bump codex sdk to latest version ([658421c](https://github.com/siteboon/claudecodeui/commit/658421c1c44ec4eb58b69ec7b1844a9fba11a3f3)) + +## [1.31.3](https://github.com/siteboon/claudecodeui/compare/v1.31.2...v1.31.3) (2026-04-30) + +## [1.31.2](https://github.com/siteboon/claudecodeui/compare/v1.31.0...v1.31.2) (2026-04-30) + +### Bug Fixes + +* migrations for new sqlite schema ([0753c04](https://github.com/siteboon/claudecodeui/commit/0753c047837dab17b86ae4453027e30b465870f8)) + +## [1.31.0](https://github.com/siteboon/claudecodeui/compare/v1.30.0...v1.31.0) (2026-04-30) + +### Bug Fixes + +* **/status:** use CLAUDE_MODELS.DEFAULT instead of stale 'claude-sonnet-4.5' fallback ([#723](https://github.com/siteboon/claudecodeui/issues/723)) ([b4a39c7](https://github.com/siteboon/claudecodeui/commit/b4a39c729710a6294c62eb742e99e05f3e3914e9)) + +## [1.30.0](https://github.com/siteboon/claudecodeui/compare/v1.29.5...v1.30.0) (2026-04-21) + +### New Features + +* **i18n:** add Italian language support ([#677](https://github.com/siteboon/claudecodeui/issues/677)) ([86b6545](https://github.com/siteboon/claudecodeui/commit/86b6545c3505475ac2de0cec75cc8f86ab22aceb)) +* **i18n:** add Turkish (tr) language support ([#678](https://github.com/siteboon/claudecodeui/issues/678)) ([89b754d](https://github.com/siteboon/claudecodeui/commit/89b754d186b68f3df8aa439a2d535644406066f0)), closes [#384](https://github.com/siteboon/claudecodeui/issues/384) [#514](https://github.com/siteboon/claudecodeui/issues/514) [#525](https://github.com/siteboon/claudecodeui/issues/525) [#534](https://github.com/siteboon/claudecodeui/issues/534) +* introduce opus 4.7 ([#682](https://github.com/siteboon/claudecodeui/issues/682)) ([c5e55ad](https://github.com/siteboon/claudecodeui/commit/c5e55adc89d0316675f90a927aa40d115958ae9f)) + +### Bug Fixes + +* iOS scrolling main chat area ([3969135](https://github.com/siteboon/claudecodeui/commit/3969135bd427fbf48f29bb3dbfedb47791ca78dc)) +* migrate PlanDisplay raw params from native details to Collapsible primitive ([fc3504e](https://github.com/siteboon/claudecodeui/commit/fc3504eaed8ca7ed9214838d148ea385b8352c31)) +* precise Claude SDK denial message detection in deriveToolStatus ([09dcea0](https://github.com/siteboon/claudecodeui/commit/09dcea05fbc8c208d931aa1f08618f0e8087392f)) +* reduce size of permission mode button tap target and provider selector on mobile ([457ca0d](https://github.com/siteboon/claudecodeui/commit/457ca0daabcaa8397f4375ee8aa2671336b648ff)) +* small mobile respnosive fixes ([25820ed](https://github.com/siteboon/claudecodeui/commit/25820ed995c1b813b1f9ed073097b08eb1d902ec)) +* small mobile respnosive fixes ([c471b5d](https://github.com/siteboon/claudecodeui/commit/c471b5d3fa6ce1968adb4cf87a15ac0e18febd20)) + +### Refactoring + +* add primitives, plan mode display, and new session model selector ([7763e60](https://github.com/siteboon/claudecodeui/commit/7763e60fb32e34742058c055c57664a503a34d1d)) +* chat composer new design ([5758bee](https://github.com/siteboon/claudecodeui/commit/5758bee8a038ed50073dba882108617959dda82c)) +* queue primitive, tool status badges, and tool display cleanup ([ec0ff97](https://github.com/siteboon/claudecodeui/commit/ec0ff974cba213a1100b2a071b8ba533e812fe82)) + +### Maintenance + +* add docker sandbox action ([fa5a238](https://github.com/siteboon/claudecodeui/commit/fa5a23897c086bcacf1cf5d926c650f98a0f2222)) + +## [1.29.5](https://github.com/siteboon/claudecodeui/compare/v1.29.4...v1.29.5) (2026-04-16) + +### Bug Fixes + +* update node-pty to latest version ([6a13e17](https://github.com/siteboon/claudecodeui/commit/6a13e1773b145049ade512aa6e5cac21c2e5c4de)) + +## [1.29.4](https://github.com/siteboon/claudecodeui/compare/v1.29.3...v1.29.4) (2026-04-16) + +### New Features + +* deleting from sidebar will now ask whether to remove all data as well ([e9c7a50](https://github.com/siteboon/claudecodeui/commit/e9c7a5041c31a6f7b2032f06abe19c52d3d4cd8c)) + +### Bug Fixes + +* pass pathToClaudeCodeExecutable to SDK when CLAUDE_CLI_PATH is set ([4c106a5](https://github.com/siteboon/claudecodeui/commit/4c106a5083d90989bbeedaefdbb68f5b3fa6fd58)), closes [#468](https://github.com/siteboon/claudecodeui/issues/468) + +### Refactoring + +* remove the sqlite3 dependency ([2895208](https://github.com/siteboon/claudecodeui/commit/289520814cf3ca36403056739ef22021f78c6033)) +* **server:** extract URL detection and color utils from index.js ([#657](https://github.com/siteboon/claudecodeui/issues/657)) ([63e996b](https://github.com/siteboon/claudecodeui/commit/63e996bb77cfa97b1f55f6bdccc50161a75a3eee)) + +### Maintenance + +* upgrade commit lint to 20.5.0 ([0948601](https://github.com/siteboon/claudecodeui/commit/09486016e67d97358c228ebc6eb4502ccb0012e4)) + +## [1.29.3](https://github.com/siteboon/claudecodeui/compare/v1.29.2...v1.29.3) (2026-04-15) + +### Bug Fixes + +* **version-upgrade-modal:** implement reload countdown and update UI messages ([#655](https://github.com/siteboon/claudecodeui/issues/655)) ([6413042](https://github.com/siteboon/claudecodeui/commit/641304242d7705b54aab65faa4a7673438c92c60)) + +### Maintenance + +* remove unused route (migrated to providers already) ([31f28a2](https://github.com/siteboon/claudecodeui/commit/31f28a2c183f6ead50941027632d7ab64b7bb2d4)) + +## [1.29.2](https://github.com/siteboon/claudecodeui/compare/v1.29.1...v1.29.2) (2026-04-14) + +### Bug Fixes + +* **sandbox:** use backgrounded sbx run to keep sandbox alive ([9b11c03](https://github.com/siteboon/claudecodeui/commit/9b11c034d9a19710a23b56c62dcf07c21a17bd97)) + +## [1.29.1](https://github.com/siteboon/claudecodeui/compare/v1.29.0...v1.29.1) (2026-04-14) + +### Bug Fixes + +* add latest tag to docker npx command and change the detach mode to work without spawn ([4a56972](https://github.com/siteboon/claudecodeui/commit/4a569725dae320a505753359d8edfd8ca79f0fd7)) + +## [1.29.0](https://github.com/siteboon/claudecodeui/compare/v1.28.1...v1.29.0) (2026-04-14) + +### New Features + +* adding docker sandbox environments ([13e97e2](https://github.com/siteboon/claudecodeui/commit/13e97e2c71254de7a60afb5495b21064c4bc4241)) + +### Bug Fixes + +* **thinking-mode:** fix dropdown positioning ([#646](https://github.com/siteboon/claudecodeui/issues/646)) ([c7a5baf](https://github.com/siteboon/claudecodeui/commit/c7a5baf1479404bd40e23aa58bd9f677df9a04c6)) + +### Maintenance + +* update release flow node version ([e2459cb](https://github.com/siteboon/claudecodeui/commit/e2459cb0f8b35f54827778a7b444e6c3ca326506)) + +## [1.28.1](https://github.com/siteboon/claudecodeui/compare/v1.28.0...v1.28.1) (2026-04-10) + +### New Features + +* add branding, community links, GitHub star badge, and About settings tab ([2207d05](https://github.com/siteboon/claudecodeui/commit/2207d05c1ca229214aa9c2e2c9f4d0827d421574)) + +### Bug Fixes + +* corrupted binary downloads ([#634](https://github.com/siteboon/claudecodeui/issues/634)) ([e61f8a5](https://github.com/siteboon/claudecodeui/commit/e61f8a543d63fe7c24a04b3d2186085a06dcbcdb)) +* **ui:** remove mobile bottom nav, unify processing indicator, and improve tooltip behavior on mobile ([#632](https://github.com/siteboon/claudecodeui/issues/632)) ([a8dab0e](https://github.com/siteboon/claudecodeui/commit/a8dab0edcf949ae610820bae9500c433781f7c73)) + +### Refactoring + +* remove unused whispher transcribe logic ([#637](https://github.com/siteboon/claudecodeui/issues/637)) ([590dd42](https://github.com/siteboon/claudecodeui/commit/590dd42649424ab990353fcf59ce0965036d3d25)) + +## [1.28.0](https://github.com/siteboon/claudecodeui/compare/v1.27.1...v1.28.0) (2026-04-03) + +### New Features + +* adding session resume in the api ([8f1042c](https://github.com/siteboon/claudecodeui/commit/8f1042cf256be282f009adcceeb55ab2dddf3fba)) +* moving new session button higher ([1628868](https://github.com/siteboon/claudecodeui/commit/16288684702dec894cf054291ca3d545ddb8214b)) + +### Maintenance + +* changing package name to @cloudcli-ai/cloudcli ([ef51de2](https://github.com/siteboon/claudecodeui/commit/ef51de259ea2b963bc15f058b084e11220bc216a)) + +## [1.27.1](https://github.com/siteboon/claudecodeui/compare/v1.26.3...v1.27.1) (2026-03-29) + +### Bug Fixes + +* prevent split on undefined（[#491](https://github.com/siteboon/claudecodeui/issues/491)） ([#563](https://github.com/siteboon/claudecodeui/issues/563)) ([b54cdf8](https://github.com/siteboon/claudecodeui/commit/b54cdf8168fc224e9907796e4229ae8ed34e6885)) + +### Maintenance + +* add release-it github action ([42a1313](https://github.com/siteboon/claudecodeui/commit/42a131389a6954df0d2c3bedd2cb6d3406c5ebc1)) +* add terminal plugin in the plugins list ([004135e](https://github.com/siteboon/claudecodeui/commit/004135ef0187023e1da29c4a7137a28a42ebf9af)) +* release tokens ([f1063fd](https://github.com/siteboon/claudecodeui/commit/f1063fd33964ccb517f5ebcdd14526ed162e1138)) +* relicense to AGPL-3.0-or-later ([27cd124](https://github.com/siteboon/claudecodeui/commit/27cd12432b7d3237981f86acd9cc99532d843d4a)) + +## [1.26.3](https://github.com/siteboon/claudecodeui/compare/v1.26.2...v1.26.3) (2026-03-22) + +## [1.26.2](https://github.com/siteboon/claudecodeui/compare/v1.26.0...v1.26.2) (2026-03-21) + +### Bug Fixes + +* change SW cache mechanism ([17d6ec5](https://github.com/siteboon/claudecodeui/commit/17d6ec54af18d333c8b04d2ffc64793e688d996e)) +* claude auth changes and adding copy on mobile ([a41d2c7](https://github.com/siteboon/claudecodeui/commit/a41d2c713e87d56f23d5884585b4bb43c43a250a)) + +## [1.26.0](https://github.com/siteboon/claudecodeui/compare/v1.25.2...v1.26.0) (2026-03-20) + +### New Features + +* add German (Deutsch) language support ([#525](https://github.com/siteboon/claudecodeui/issues/525)) ([a7299c6](https://github.com/siteboon/claudecodeui/commit/a7299c68237908c752d504c2e8eea91570a30203)) +* add WebSocket proxy for plugin backends ([#553](https://github.com/siteboon/claudecodeui/issues/553)) ([88c60b7](https://github.com/siteboon/claudecodeui/commit/88c60b70b031798d51ce26c8f080a0f64d824b05)) +* Browser autofill support for login form ([#521](https://github.com/siteboon/claudecodeui/issues/521)) ([72ff134](https://github.com/siteboon/claudecodeui/commit/72ff134b315b7a1d602f3cc7dd60d47c1c1c34af)) +* git panel redesign ([#535](https://github.com/siteboon/claudecodeui/issues/535)) ([adb3a06](https://github.com/siteboon/claudecodeui/commit/adb3a06d7e66a6d2dbcdfb501615e617178314af)) +* introduce notification system and claude notifications ([#450](https://github.com/siteboon/claudecodeui/issues/450)) ([45e71a0](https://github.com/siteboon/claudecodeui/commit/45e71a0e73b368309544165e4dcf8b7fd014e8dd)) +* **refactor:** move plugins to typescript ([#557](https://github.com/siteboon/claudecodeui/issues/557)) ([612390d](https://github.com/siteboon/claudecodeui/commit/612390db536417e2f68c501329bfccf5c6795e45)) +* unified message architecture with provider adapters and session store ([#558](https://github.com/siteboon/claudecodeui/issues/558)) ([a4632dc](https://github.com/siteboon/claudecodeui/commit/a4632dc4cec228a8febb7c5bae4807c358963678)) + +### Bug Fixes + +* detect Claude auth from settings env ([#527](https://github.com/siteboon/claudecodeui/issues/527)) ([95bcee0](https://github.com/siteboon/claudecodeui/commit/95bcee0ec459f186d52aeffe100ac1a024e92909)) +* remove /exit command from claude login flow during onboarding ([#552](https://github.com/siteboon/claudecodeui/issues/552)) ([4de8b78](https://github.com/siteboon/claudecodeui/commit/4de8b78c6db5d8c2c402afce0f0b4cc16d5b6496)) + +### Documentation + +* add German language link to all README files ([#534](https://github.com/siteboon/claudecodeui/issues/534)) ([1d31c3e](https://github.com/siteboon/claudecodeui/commit/1d31c3ec8309b433a041f3099955addc8c136c35)) +* **readme:** hotfix and improve for README.jp.md ([#550](https://github.com/siteboon/claudecodeui/issues/550)) ([7413c2c](https://github.com/siteboon/claudecodeui/commit/7413c2c78422c308ac949e6a83c3e9216b24b649)) +* **README:** update translations with CloudCLI branding and feature restructuring ([#544](https://github.com/siteboon/claudecodeui/issues/544)) ([14aef73](https://github.com/siteboon/claudecodeui/commit/14aef73cc6085fbb519fe64aea7cac80b7d51285)) + +## [1.25.2](https://github.com/siteboon/claudecodeui/compare/v1.25.0...v1.25.2) (2026-03-11) + +### New Features + +* **i18n:** localize plugin settings for all languages ([#515](https://github.com/siteboon/claudecodeui/issues/515)) ([621853c](https://github.com/siteboon/claudecodeui/commit/621853cbfb4233b34cb8cc2e1ed10917ba424352)) + +### Bug Fixes + +* codeql user value provided path validation ([aaa14b9](https://github.com/siteboon/claudecodeui/commit/aaa14b9fc0b9b51c4fb9d1dba40fada7cbbe0356)) +* numerous bugs ([#528](https://github.com/siteboon/claudecodeui/issues/528)) ([a77f213](https://github.com/siteboon/claudecodeui/commit/a77f213dd5d0b2538dea091ab8da6e55d2002f2f)) +* **security:** disable executable gray-matter frontmatter in commands ([b9c902b](https://github.com/siteboon/claudecodeui/commit/b9c902b016f411a942c8707dd07d32b60bad087c)) +* session reconnect catch-up, always-on input, frozen session recovery ([#524](https://github.com/siteboon/claudecodeui/issues/524)) ([4d8fb6e](https://github.com/siteboon/claudecodeui/commit/4d8fb6e30aa03d7cdb92bd62b7709422f9d08e32)) + +### Refactoring + +* new settings page design and new pill component ([8ddeeb0](https://github.com/siteboon/claudecodeui/commit/8ddeeb0ce8d0642560bd3fa149236011dc6e3707)) + +## [1.25.0](https://github.com/siteboon/claudecodeui/compare/v1.24.0...v1.25.0) (2026-03-10) + +### New Features + +* add copy as text or markdown feature for assistant messages ([#519](https://github.com/siteboon/claudecodeui/issues/519)) ([1dc2a20](https://github.com/siteboon/claudecodeui/commit/1dc2a205dc2a3cbf960625d7669c7c63a2b6905f)) +* add full Russian language support; update Readme.md files, and .gitignore update ([#514](https://github.com/siteboon/claudecodeui/issues/514)) ([c7dcba8](https://github.com/siteboon/claudecodeui/commit/c7dcba8d9117e84db8aac7d8a7bf6a3aa683e115)) +* new plugin system ([#489](https://github.com/siteboon/claudecodeui/issues/489)) ([8afb46a](https://github.com/siteboon/claudecodeui/commit/8afb46af2e5514c9284030367281793fbb014e4f)) + +### Bug Fixes + +* resolve duplicate key issue when rendering model options ([#520](https://github.com/siteboon/claudecodeui/issues/520)) ([9bceab9](https://github.com/siteboon/claudecodeui/commit/9bceab9e1a6e063b0b4f934ed2d9f854fcc9c6a4)) + +### Maintenance + +* add plugins section in readme ([e581a0e](https://github.com/siteboon/claudecodeui/commit/e581a0e1ccd59fd7ec7306ca76a13e73d7c674c1)) + +## [1.24.0](https://github.com/siteboon/claudecodeui/compare/v1.23.2...v1.24.0) (2026-03-09) + +### New Features + +* add full-text search across conversations ([#482](https://github.com/siteboon/claudecodeui/issues/482)) ([3950c0e](https://github.com/siteboon/claudecodeui/commit/3950c0e47f41e93227af31494690818d45c8bc7a)) + +### Bug Fixes + +* **git:** prevent shell injection in git routes ([86c33c1](https://github.com/siteboon/claudecodeui/commit/86c33c1c0cb34176725a38f46960213714fc3e04)) +* replace getDatabase with better-sqlite3 db in getGithubTokenById ([#501](https://github.com/siteboon/claudecodeui/issues/501)) ([cb4fd79](https://github.com/siteboon/claudecodeui/commit/cb4fd795c938b1cc86d47f401973bfccdd68fdee)) + +## [1.23.2](https://github.com/siteboon/claudecodeui/compare/v1.22.1...v1.23.2) (2026-03-06) + +### New Features + +* add clickable overlay buttons for CLI prompts in Shell terminal ([#480](https://github.com/siteboon/claudecodeui/issues/480)) ([2444209](https://github.com/siteboon/claudecodeui/commit/2444209723701dda2b881cea2501b239e64e51c1)), closes [#427](https://github.com/siteboon/claudecodeui/issues/427) +* add terminal shortcuts panel for mobile ([#411](https://github.com/siteboon/claudecodeui/issues/411)) ([b0a3fdf](https://github.com/siteboon/claudecodeui/commit/b0a3fdf95ffdb961261194d10400267251e42f17)) +* implement session rename with SQLite storage ([#413](https://github.com/siteboon/claudecodeui/issues/413)) ([198e3da](https://github.com/siteboon/claudecodeui/commit/198e3da89b353780f53a91888384da9118995e81)), closes [#72](https://github.com/siteboon/claudecodeui/issues/72) [#358](https://github.com/siteboon/claudecodeui/issues/358) + +### Bug Fixes + +* **chat:** finalize terminal lifecycle to prevent stuck processing/thinking UI ([#483](https://github.com/siteboon/claudecodeui/issues/483)) ([0590c5c](https://github.com/siteboon/claudecodeui/commit/0590c5c178f4791e2b039d525ecca4d220c3dcae)) +* **codex-history:** prevent AGENTS.md/internal prompt leakage when reloading Codex sessions ([#488](https://github.com/siteboon/claudecodeui/issues/488)) ([64a96b2](https://github.com/siteboon/claudecodeui/commit/64a96b24f853acb802f700810b302f0f5cf00898)) +* preserve pending permission requests across WebSocket reconnections ([#462](https://github.com/siteboon/claudecodeui/issues/462)) ([4ee88f0](https://github.com/siteboon/claudecodeui/commit/4ee88f0eb0c648b54b05f006c6796fb7b09b0fae)) +* prevent React 18 batching from losing messages during session sync ([#461](https://github.com/siteboon/claudecodeui/issues/461)) ([688d734](https://github.com/siteboon/claudecodeui/commit/688d73477a50773e43c85addc96212aa6290aea5)) +* release it script ([dcea8a3](https://github.com/siteboon/claudecodeui/commit/dcea8a329c7d68437e1e72c8c766cf33c74637e9)) + +### Styling + +* improve UI for processing banner ([#477](https://github.com/siteboon/claudecodeui/issues/477)) ([2320e1d](https://github.com/siteboon/claudecodeui/commit/2320e1d74b59c65b5b7fc4fa8b05fd9208f4898c)) + +### Maintenance + +* remove logging of received WebSocket messages in production ([#487](https://github.com/siteboon/claudecodeui/issues/487)) ([9193feb](https://github.com/siteboon/claudecodeui/commit/9193feb6dc83041f3c365204648a88468bdc001b)) + +## [1.22.0](https://github.com/siteboon/claudecodeui/compare/v1.21.0...v1.22.0) (2026-03-03) + +### New Features + +* add community button in the app ([84d4634](https://github.com/siteboon/claudecodeui/commit/84d4634735f9ee13ac1c20faa0e7e31f1b77cae8)) +* Advanced file editor and file tree improvements ([#444](https://github.com/siteboon/claudecodeui/issues/444)) ([9768958](https://github.com/siteboon/claudecodeui/commit/97689588aa2e8240ba4373da5f42ab444c772e72)) +* update document title based on selected project ([#448](https://github.com/siteboon/claudecodeui/issues/448)) ([9e22f42](https://github.com/siteboon/claudecodeui/commit/9e22f42a3d3a781f448ddac9d133292fe103bb8c)) + +### Bug Fixes + +* **claude:** correct project encoded path ([#451](https://github.com/siteboon/claudecodeui/issues/451)) ([9c0e864](https://github.com/siteboon/claudecodeui/commit/9c0e864532dcc5ce7ee890d3b4db722872db2b54)), closes [#447](https://github.com/siteboon/claudecodeui/issues/447) +* **claude:** move model usage log to result message only ([#454](https://github.com/siteboon/claudecodeui/issues/454)) ([506d431](https://github.com/siteboon/claudecodeui/commit/506d43144b3ec3155c3e589e7e803862c4a8f83a)) +* missing translation label ([855e22f](https://github.com/siteboon/claudecodeui/commit/855e22f9176a71daa51de716370af7f19d55bfb4)) + +### Maintenance + +* add Gemini-CLI support to README ([#453](https://github.com/siteboon/claudecodeui/issues/453)) ([503c384](https://github.com/siteboon/claudecodeui/commit/503c3846850fb843781979b0c0e10a24b07e1a4b)) + +## [1.21.0](https://github.com/siteboon/claudecodeui/compare/v1.20.1...v1.21.0) (2026-02-27) + +### New Features + +* add copy icon for user messages ([#449](https://github.com/siteboon/claudecodeui/issues/449)) ([b359c51](https://github.com/siteboon/claudecodeui/commit/b359c515277b4266fde2fb9a29b5356949c07c4f)) +* Google's gemini-cli integration ([#422](https://github.com/siteboon/claudecodeui/issues/422)) ([a367edd](https://github.com/siteboon/claudecodeui/commit/a367edd51578608b3281373cb4a95169dbf17f89)) +* persist active tab across reloads via localStorage ([#414](https://github.com/siteboon/claudecodeui/issues/414)) ([e3b6892](https://github.com/siteboon/claudecodeui/commit/e3b689214f11d549ffe1b3a347476d58f25c5aca)), closes [#387](https://github.com/siteboon/claudecodeui/issues/387) + +### Bug Fixes + +* add support for Codex in the shell ([#424](https://github.com/siteboon/claudecodeui/issues/424)) ([23801e9](https://github.com/siteboon/claudecodeui/commit/23801e9cc15d2b8d1bfc6e39aee2fae93226d1ad)) + +### Maintenance + +* upgrade @anthropic-ai/claude-agent-sdk to version 0.2.59 and add model usage logging ([#446](https://github.com/siteboon/claudecodeui/issues/446)) ([917c353](https://github.com/siteboon/claudecodeui/commit/917c353115653ee288bf97be01f62fad24123cbc)) +* upgrade better-sqlite to latest version to support node 25 ([#445](https://github.com/siteboon/claudecodeui/issues/445)) ([4ab94fc](https://github.com/siteboon/claudecodeui/commit/4ab94fce4257e1e20370fa83fa4c0f6fadbb8a2b)) + +## [1.20.1](https://github.com/siteboon/claudecodeui/compare/v1.19.1...v1.20.1) (2026-02-23) + +### New Features + +* implement install mode detection and update commands in version upgrade process ([f986004](https://github.com/siteboon/claudecodeui/commit/f986004319207b068431f9f6adf338a8ce8decfc)) +* migrate legacy database to new location and improve last login update handling ([50e097d](https://github.com/siteboon/claudecodeui/commit/50e097d4ac498aa9f1803ef3564843721833dc19)) + +## [1.19.1](https://github.com/siteboon/claudecodeui/compare/v1.19.0...v1.19.1) (2026-02-23) + +### Bug Fixes + +* add prepublishOnly script to build before publishing ([82efac4](https://github.com/siteboon/claudecodeui/commit/82efac4704cab11ed8d1a05fe84f41312140b223)) + +## [1.19.0](https://github.com/siteboon/claudecodeui/compare/v1.18.2...v1.19.0) (2026-02-23) + +### New Features + +* add HOST environment variable for configurable bind address ([#360](https://github.com/siteboon/claudecodeui/issues/360)) ([cccd915](https://github.com/siteboon/claudecodeui/commit/cccd915c336192216b6e6f68e2b5f3ece0ccf966)) +* subagent tool grouping ([#398](https://github.com/siteboon/claudecodeui/issues/398)) ([0207a1f](https://github.com/siteboon/claudecodeui/commit/0207a1f3a3c87f1c6c1aee8213be999b23289386)) + +### Bug Fixes + +* **macos:** fix node-pty posix_spawnp error with postinstall script ([#347](https://github.com/siteboon/claudecodeui/issues/347)) ([38a593c](https://github.com/siteboon/claudecodeui/commit/38a593c97fdb2bb7f051e09e8e99c16035448655)), closes [#284](https://github.com/siteboon/claudecodeui/issues/284) +* slash commands with arguments bypass command execution ([#392](https://github.com/siteboon/claudecodeui/issues/392)) ([597e9c5](https://github.com/siteboon/claudecodeui/commit/597e9c54b76e7c6cd1947299c668c78d24019cab)) + +### Refactoring + +* **releases:** Create a contributing guide and proper release notes using a release-it plugin ([fc369d0](https://github.com/siteboon/claudecodeui/commit/fc369d047e13cba9443fe36c0b6bb2ce3beaf61c)) + +### Maintenance + +* update @anthropic-ai/claude-agent-sdk to version 0.1.77 in package-lock.json ([#410](https://github.com/siteboon/claudecodeui/issues/410)) ([7ccbc8d](https://github.com/siteboon/claudecodeui/commit/7ccbc8d92d440e18c157b656c9ea2635044a64f6)) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..6ada52a --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,156 @@ +# Contributing to CloudCLI UI + +Thanks for your interest in contributing to CloudCLI UI! Before you start, please take a moment to read through this guide. + +## Before You Start + +- **Search first.** Check [existing issues](https://github.com/siteboon/claudecodeui/issues) and [pull requests](https://github.com/siteboon/claudecodeui/pulls) to avoid duplicating work. +- **Discuss first** for new features. Open an [issue](https://github.com/siteboon/claudecodeui/issues/new) to discuss your idea before investing time in implementation. We may already have plans or opinions on how it should work. +- **Bug fixes are always welcome.** If you spot a bug, feel free to open a PR directly. + +## Prerequisites + +- [Node.js](https://nodejs.org/) 22 or later +- [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and configured + +## Getting Started + +1. Fork the repository +2. Clone your fork: + ```bash + git clone https://github.com//claudecodeui.git + cd claudecodeui + ``` +3. Install dependencies: + ```bash + npm install + ``` +4. Start the development server: + ```bash + npm run dev + ``` +5. Create a branch for your changes: + ```bash + git checkout -b feat/your-feature-name + ``` + +## Project Structure + +``` +claudecodeui/ +├── src/ # React frontend (Vite + Tailwind) +│ ├── components/ # UI components +│ ├── contexts/ # React context providers +│ ├── hooks/ # Custom React hooks +│ ├── i18n/ # Internationalization and translations +│ ├── lib/ # Shared frontend libraries +│ ├── types/ # TypeScript type definitions +│ └── utils/ # Frontend utilities +├── server/ # Express backend +│ ├── routes/ # API route handlers +│ ├── middleware/ # Express middleware +│ ├── database/ # SQLite database layer +│ └── tools/ # CLI tool integrations +├── shared/ # Code shared between client and server +└── public/ # Static assets, icons, PWA manifest +``` + +## Development Workflow + +- `npm run dev` — Start both the frontend and backend in development mode +- `npm run build` — Create a production build +- `npm run server` — Start only the backend server +- `npm run client` — Start only the Vite dev server + +## Making Changes + +### Bug Fixes + +- Reference the issue number in your PR if one exists +- Describe how to reproduce the bug in your PR description +- Add a screenshot or recording for visual bugs + +### New Features + +- Keep the scope focused — one feature per PR +- Include screenshots or recordings for UI changes + +### Documentation + +- Documentation improvements are always welcome +- Keep language clear and concise + +## Commit Convention + +We follow [Conventional Commits](https://conventionalcommits.org/) to generate release notes automatically. Every commit message should follow this format: + +``` +(optional scope): +``` + +Use imperative, present tense: "add feature" not "added feature" or "adds feature". + +### Types + +| Type | Description | +|------|-------------| +| `feat` | A new feature | +| `fix` | A bug fix | +| `perf` | A performance improvement | +| `refactor` | Code change that neither fixes a bug nor adds a feature | +| `docs` | Documentation only | +| `style` | CSS, formatting, visual changes | +| `chore` | Maintenance, dependencies, config | +| `ci` | CI/CD pipeline changes | +| `test` | Adding or updating tests | +| `build` | Build system changes | + +### Examples + +```bash +feat: add conversation search +feat(i18n): add Japanese language support +fix: redirect unauthenticated users to login +fix(editor): syntax highlighting for .env files +perf: lazy load code editor component +refactor(chat): extract message list component +docs: update API configuration guide +``` + +### Breaking Changes + +Add `!` after the type or include `BREAKING CHANGE:` in the commit footer: + +```bash +feat!: redesign settings page layout +``` + +## Pull Requests + +- Give your PR a clear, descriptive title following the commit convention above +- Fill in the PR description with what changed and why +- Link any related issues +- Include screenshots for UI changes +- Make sure the build passes (`npm run build`) +- Keep PRs focused — avoid unrelated changes + +## Releases + +Releases are managed by maintainers using [release-it](https://github.com/release-it/release-it) with the [conventional changelog plugin](https://github.com/release-it/conventional-changelog). + +```bash +npm run release # interactive (prompts for version bump) +npm run release -- patch # patch release +npm run release -- minor # minor release +``` + +This automatically: +- Bumps the version based on commit types (`feat` = minor, `fix` = patch) +- Generates categorized release notes +- Updates `CHANGELOG.md` +- Creates a git tag and GitHub Release +- Publishes to npm + +## License + +By contributing, you agree that your contributions will be licensed under the [AGPL-3.0-or-later License](LICENSE), including the additional terms specified in Section 7 of the LICENSE file. \ No newline at end of file diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..3cde302 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,27 @@ +FROM node:20-bookworm-slim + +# Install build deps for native modules (node-pty, better-sqlite3, bcrypt) +RUN apt-get update && apt-get install -y --no-install-recommends \ + build-essential python3 python3-setuptools \ + jq ripgrep sqlite3 zip unzip tree vim-tiny curl git \ + && rm -rf /var/lib/apt/lists/* + +# Install Claude Code CLI globally +RUN npm install -g @anthropic-ai/claude-code + +# Install CloudCLI (claudecodeui) globally +RUN npm install -g @cloudcli-ai/cloudcli + +# Install Taskmaster MCP +RUN npm install -g task-master-ai + +# Create workspace and data dirs with correct ownership +RUN mkdir -p /home/node/workspace /home/node/.cloudcli \ + && chown -R node:node /home/node/ + +USER node +WORKDIR /home/node + +EXPOSE 3001 + +CMD ["cloudcli", "start", "--port", "3001"] diff --git a/LICENSE b/LICENSE new file mode 100755 index 0000000..b9620f5 --- /dev/null +++ b/LICENSE @@ -0,0 +1,718 @@ + GNU AFFERO GENERAL PUBLIC LICENSE + Version 3, 19 November 2007 + + Copyright (C) 2007 Free Software Foundation, Inc. + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The GNU Affero General Public License is a free, copyleft license for +software and other kinds of works, specifically designed to ensure +cooperation with the community in the case of network server software. + + The licenses for most software and other practical works are designed +to take away your freedom to share and change the works. By contrast, +our General Public Licenses are intended to guarantee your freedom to +share and change all versions of a program--to make sure it remains free +software for all its users. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +them if you wish), that you receive source code or can get it if you +want it, that you can change the software or use pieces of it in new +free programs, and that you know you can do these things. + + Developers that use our General Public Licenses protect your rights +with two steps: (1) assert copyright on the software, and (2) offer +you this License which gives you legal permission to copy, distribute +and/or modify the software. + + A secondary benefit of defending all users' freedom is that +improvements made in alternate versions of the program, if they +receive widespread use, become available for other developers to +incorporate. Many developers of free software are heartened and +encouraged by the resulting cooperation. However, in the case of +software used on network servers, this result may fail to come about. +The GNU General Public License permits making a modified version and +letting the public access it on a server without ever releasing its +source code to the public. + + The GNU Affero General Public License is designed specifically to +ensure that, in such cases, the modified source code becomes available +to the community. It requires the operator of a network server to +provide the source code of the modified version running there to the +users of that server. Therefore, public use of a modified version, on +a publicly accessible server, gives the public access to the source +code of the modified version. + + An older license, called the Affero General Public License and +published by Affero, was designed to accomplish similar goals. This is +a different license, not a version of the Affero GPL, but Affero has +released a new version of the Affero GPL which permits relicensing under +this license. + + The precise terms and conditions for copying, distribution and +modification follow. + + TERMS AND CONDITIONS + + 0. Definitions. + + "This License" refers to version 3 of the GNU Affero General Public License. + + "Copyright" also means copyright-like laws that apply to other kinds of +works, such as semiconductor masks. + + "The Program" refers to any copyrightable work licensed under this +License. Each licensee is addressed as "you". "Licensees" and +"recipients" may be individuals or organizations. + + To "modify" a work means to copy from or adapt all or part of the work +in a fashion requiring copyright permission, other than the making of an +exact copy. The resulting work is called a "modified version" of the +earlier work or a work "based on" the earlier work. + + A "covered work" means either the unmodified Program or a work based +on the Program. + + To "propagate" a work means to do anything with it that, without +permission, would make you directly or secondarily liable for +infringement under applicable copyright law, except executing it on a +computer or modifying a private copy. Propagation includes copying, +distribution (with or without modification), making available to the +public, and in some countries other activities as well. + + To "convey" a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through +a computer network, with no transfer of a copy, is not conveying. + + An interactive user interface displays "Appropriate Legal Notices" +to the extent that it includes a convenient and prominently visible +feature that (1) displays an appropriate copyright notice, and (2) +tells the user that there is no warranty for the work (except to the +extent that warranties are provided), that licensees may convey the +work under this License, and how to view a copy of this License. If +the interface presents a list of user commands or options, such as a +menu, a prominent item in the list meets this criterion. + + 1. Source Code. + + The "source code" for a work means the preferred form of the work +for making modifications to it. "Object code" means any non-source +form of a work. + + A "Standard Interface" means an interface that either is an official +standard defined by a recognized standards body, or, in the case of +interfaces specified for a particular programming language, one that +is widely used among developers working in that language. + + The "System Libraries" of an executable work include anything, other +than the work as a whole, that (a) is included in the normal form of +packaging a Major Component, but which is not part of that Major +Component, and (b) serves only to enable use of the work with that +Major Component, or to implement a Standard Interface for which an +implementation is available to the public in source code form. A +"Major Component", in this context, means a major essential component +(kernel, window system, and so on) of the specific operating system +(if any) on which the executable work runs, or a compiler used to +produce the work, or an object code interpreter used to run it. + + The "Corresponding Source" for a work in object code form means all +the source code needed to generate, install, and (for an executable +work) run the object code and to modify the work, including scripts to +control those activities. However, it does not include the work's +System Libraries, or general-purpose tools or generally available free +programs which are used unmodified in performing those activities but +which are not part of the work. For example, Corresponding Source +includes interface definition files associated with source files for +the work, and the source code for shared libraries and dynamically +linked subprograms that the work is specifically designed to require, +such as by intimate data communication or control flow between those +subprograms and other parts of the work. + + The Corresponding Source need not include anything that users +can regenerate automatically from other parts of the Corresponding +Source. + + The Corresponding Source for a work in source code form is that +same work. + + 2. Basic Permissions. + + All rights granted under this License are granted for the term of +copyright on the Program, and are irrevocable provided the stated +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a +covered work is covered by this License only if the output, given its +content, constitutes a covered work. This License acknowledges your +rights of fair use or other equivalent, as provided by copyright law. + + You may make, run and propagate covered works that you do not +convey, without conditions so long as your license otherwise remains +in force. You may convey covered works to others for the sole purpose +of having them make modifications exclusively for you, or provide you +with facilities for running those works, provided that you comply with +the terms of this License in conveying all material for which you do +not control copyright. Those thus making or running the covered works +for you must do so exclusively on your behalf, under your direction +and control, on terms that prohibit them from making any copies of +your copyrighted material outside their relationship with you. + + Conveying under any other circumstances is permitted solely under +the conditions stated below. Sublicensing is not allowed; section 10 +makes it unnecessary. + + 3. Protecting Users' Legal Rights From Anti-Circumvention Law. + + No covered work shall be deemed part of an effective technological +measure under any applicable law fulfilling obligations under article +11 of the WIPO copyright treaty adopted on 20 December 1996, or +similar laws prohibiting or restricting circumvention of such +measures. + + When you convey a covered work, you waive any legal power to forbid +circumvention of technological measures to the extent such circumvention +is effected by exercising rights under this License with respect to +the covered work, and you disclaim any intention to limit operation or +modification of the work as a means of enforcing, against the work's +users, your or third parties' legal rights to forbid circumvention of +technological measures. + + 4. Conveying Verbatim Copies. + + You may convey verbatim copies of the Program's source code as you +receive it, in any medium, provided that you conspicuously and +appropriately publish on each copy an appropriate copyright notice; +keep intact all notices stating that this License and any +non-permissive terms added in accord with section 7 apply to the code; +keep intact all notices of the absence of any warranty; and give all +recipients a copy of this License along with the Program. + + You may charge any price or no price for each copy that you convey, +and you may offer support or warranty protection for a fee. + + 5. Conveying Modified Source Versions. + + You may convey a work based on the Program, or the modifications to +produce it from the Program, in the form of source code under the +terms of section 4, provided that you also meet all of these conditions: + + a) The work must carry prominent notices stating that you modified + it, and giving a relevant date. + + b) The work must carry prominent notices stating that it is + released under this License and any conditions added under section + 7. This requirement modifies the requirement in section 4 to + "keep intact all notices". + + c) You must license the entire work, as a whole, under this + License to anyone who comes into possession of a copy. This + License will therefore apply, along with any applicable section 7 + additional terms, to the whole of the work, and all its parts, + regardless of how they are packaged. This License gives no + permission to license the work in any other way, but it does not + invalidate such permission if you have separately received it. + + d) If the work has interactive user interfaces, each must display + Appropriate Legal Notices; however, if the Program has interactive + interfaces that do not display Appropriate Legal Notices, your + work need not make them do so. + + A compilation of a covered work with other separate and independent +works, which are not by their nature extensions of the covered work, +and which are not combined with it such as to form a larger program, +in or on a volume of a storage or distribution medium, is called an +"aggregate" if the compilation and its resulting copyright are not +used to limit the access or legal rights of the compilation's users +beyond what the individual works permit. Inclusion of a covered work +in an aggregate does not cause this License to apply to the other +parts of the aggregate. + + 6. Conveying Non-Source Forms. + + You may convey a covered work in object code form under the terms +of sections 4 and 5, provided that you also convey the +machine-readable Corresponding Source under the terms of this License, +in one of these ways: + + a) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by the + Corresponding Source fixed on a durable physical medium + customarily used for software interchange. + + b) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by a + written offer, valid for at least three years and valid for as + long as you offer spare parts or customer support for that product + model, to give anyone who possesses the object code either (1) a + copy of the Corresponding Source for all the software in the + product that is covered by this License, on a durable physical + medium customarily used for software interchange, for a price no + more than your reasonable cost of physically performing this + conveying of source, or (2) access to copy the + Corresponding Source from a network server at no charge. + + c) Convey individual copies of the object code with a copy of the + written offer to provide the Corresponding Source. This + alternative is allowed only occasionally and noncommercially, and + only if you received the object code with such an offer, in accord + with subsection 6b. + + d) Convey the object code by offering access from a designated + place (gratis or for a charge), and offer equivalent access to the + Corresponding Source in the same way through the same place at no + further charge. You need not require recipients to copy the + Corresponding Source along with the object code. If the place to + copy the object code is a network server, the Corresponding Source + may be on a different server (operated by you or a third party) + that supports equivalent copying facilities, provided you maintain + clear directions next to the object code saying where to find the + Corresponding Source. Regardless of what server hosts the + Corresponding Source, you remain obligated to ensure that it is + available for as long as needed to satisfy these requirements. + + e) Convey the object code using peer-to-peer transmission, provided + you inform other peers where the object code and Corresponding + Source of the work are being offered to the general public at no + charge under subsection 6d. + + A separable portion of the object code, whose source code is excluded +from the Corresponding Source as a System Library, need not be +included in conveying the object code work. + + A "User Product" is either (1) a "consumer product", which means any +tangible personal property which is normally used for personal, family, +or household purposes, or (2) anything designed or sold for incorporation +into a dwelling. In determining whether a product is a consumer product, +doubtful cases shall be resolved in favor of coverage. For a particular +product received by a particular user, "normally used" refers to a +typical or common use of that class of product, regardless of the status +of the particular user or of the way in which the particular user +actually uses, or expects or is expected to use, the product. A product +is a consumer product regardless of whether the product has substantial +commercial, industrial or non-consumer uses, unless such uses represent +the only significant mode of use of the product. + + "Installation Information" for a User Product means any methods, +procedures, authorization keys, or other information required to install +and execute modified versions of a covered work in that User Product from +a modified version of its Corresponding Source. The information must +suffice to ensure that the continued functioning of the modified object +code is in no case prevented or interfered with solely because +modification has been made. + + If you convey an object code work under this section in, or with, or +specifically for use in, a User Product, and the conveying occurs as +part of a transaction in which the right of possession and use of the +User Product is transferred to the recipient in perpetuity or for a +fixed term (regardless of how the transaction is characterized), the +Corresponding Source conveyed under this section must be accompanied +by the Installation Information. But this requirement does not apply +if neither you nor any third party retains the ability to install +modified object code on the User Product (for example, the work has +been installed in ROM). + + The requirement to provide Installation Information does not include a +requirement to continue to provide support service, warranty, or updates +for a work that has been modified or installed by the recipient, or for +the User Product in which it has been modified or installed. Access to a +network may be denied when the modification itself materially and +adversely affects the operation of the network or violates the rules and +protocols for communication across the network. + + Corresponding Source conveyed, and Installation Information provided, +in accord with this section must be in a format that is publicly +documented (and with an implementation available to the public in +source code form), and must require no special password or key for +unpacking, reading or copying. + + 7. Additional Terms. + + "Additional permissions" are terms that supplement the terms of this +License by making exceptions from one or more of its conditions. +Additional permissions that are applicable to the entire Program shall +be treated as though they were included in this License, to the extent +that they are valid under applicable law. If additional permissions +apply only to part of the Program, that part may be used separately +under those permissions, but the entire Program remains governed by +this License without regard to the additional permissions. + + When you convey a copy of a covered work, you may at your option +remove any additional permissions from that copy, or from any part of +it. (Additional permissions may be written to require their own +removal in certain cases when you modify the work.) You may place +additional permissions on material, added by you to a covered work, +for which you have or can give appropriate copyright permission. + + Notwithstanding any other provision of this License, for material you +add to a covered work, you may (if authorized by the copyright holders of +that material) supplement the terms of this License with terms: + + a) Disclaiming warranty or limiting liability differently from the + terms of sections 15 and 16 of this License; or + + b) Requiring preservation of specified reasonable legal notices or + author attributions in that material or in the Appropriate Legal + Notices displayed by works containing it; or + + c) Prohibiting misrepresentation of the origin of that material, or + requiring that modified versions of such material be marked in + reasonable ways as different from the original version; or + + d) Limiting the use for publicity purposes of names of licensors or + authors of the material; or + + e) Declining to grant rights under trademark law for use of some + trade names, trademarks, or service marks; or + + f) Requiring indemnification of licensors and authors of that + material by anyone who conveys the material (or modified versions of + it) with contractual assumptions of liability to the recipient, for + any liability that these contractual assumptions directly impose on + those licensors and authors. + + All other non-permissive additional terms are considered "further +restrictions" within the meaning of section 10. If the Program as you +received it, or any part of it, contains a notice stating that it is +governed by this License along with a term that is a further +restriction, you may remove that term. If a license document contains +a further restriction but permits relicensing or conveying under this +License, you may add to a covered work material governed by the terms +of that license document, provided that the further restriction does +not survive such relicensing or conveying. + + If you add terms to a covered work in accord with this section, you +must place, in the relevant source files, a statement of the +additional terms that apply to those files, or a notice indicating +where to find the applicable terms. + + Additional terms, permissive or non-permissive, may be stated in the +form of a separately written license, or stated as exceptions; +the above requirements apply either way. + + 8. Termination. + + You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise to propagate or +modify it is void, and will automatically terminate your rights under +this License (including any patent licenses granted under the third +paragraph of section 11). + + However, if you cease all violation of this License, then your +license from a particular copyright holder is reinstated (a) +provisionally, unless and until the copyright holder explicitly and +finally terminates your license, and (b) permanently, if the copyright +holder fails to notify you of the violation by some reasonable means +prior to 60 days after the cessation. + + Moreover, your license from a particular copyright holder is +reinstated permanently if the copyright holder notifies you of the +violation by some reasonable means, this is the first time you have +received notice of violation of this License (for any work) from that +copyright holder, and you cure the violation prior to 30 days after +your receipt of the notice. + + Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, you do not qualify to receive new licenses for the same +material under section 10. + + 9. Acceptance Not Required for Having Copies. + + You are not required to accept this License in order to receive or +run a copy of the Program. Ancillary propagation of a covered work +occurring solely as a consequence of using peer-to-peer transmission +to receive a copy likewise does not require acceptance. However, +nothing other than this License grants you permission to propagate or +modify any covered work. These actions infringe copyright if you do +not accept this License. Therefore, by modifying or propagating a +covered work, you indicate your acceptance of this License to do so. + + 10. Automatic Licensing of Downstream Recipients. + + Each time you convey a covered work, the recipient automatically +receives a license from the original licensors, to run, modify and +propagate that work, subject to this License. You are not responsible +for enforcing compliance by third parties with this License. + + An "entity transaction" is a transaction transferring control of an +organization, or substantially all assets of one, or subdividing an +organization, or merging organizations. If propagation of a covered +work results from an entity transaction, each party to that +transaction who receives a copy of the work also receives whatever +licenses to the work the party's predecessor in interest had or could +give under the previous paragraph, plus a right to possession of the +Corresponding Source of the work from the predecessor in interest, if +the predecessor has it or can get it with reasonable efforts. + + You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may +not impose a license fee, royalty, or other charge for exercise of +rights granted under this License, and you may not initiate litigation +(including a cross-claim or counterclaim in a lawsuit) alleging that +any patent claim is infringed by making, using, selling, offering for +sale, or importing the Program or any portion of it. + + 11. Patents. + + A "contributor" is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The +work thus licensed is called the contributor's "contributor version". + + A contributor's "essential patent claims" are all patent claims +owned or controlled by the contributor, whether already acquired or +hereafter acquired, that would be infringed by some manner, permitted +by this License, of making, using, or selling its contributor version, +but do not include claims that would be infringed only as a +consequence of further modification of the contributor version. For +purposes of this definition, "control" includes the right to grant +patent sublicenses in a manner consistent with the requirements of +this License. + + Each contributor grants you a non-exclusive, worldwide, royalty-free +patent license under the contributor's essential patent claims, to +make, use, sell, offer for sale, import and otherwise run, modify and +propagate the contents of its contributor version. + + In the following three paragraphs, a "patent license" is any express +agreement or commitment, however denominated, not to enforce a patent +(such as an express permission to practice a patent or covenant not to +sue for patent infringement). To "grant" such a patent license to a +party means to make such an agreement or commitment not to enforce a +patent against the party. + + If you convey a covered work, knowingly relying on a patent license, +and the Corresponding Source of the work is not available for anyone +to copy, free of charge and under the terms of this License, through a +publicly available network server or other readily accessible means, +then you must either (1) cause the Corresponding Source to be so +available, or (2) arrange to deprive yourself of the benefit of the +patent license for this particular work, or (3) arrange, in a manner +consistent with the requirements of this License, to extend the patent +license to downstream recipients. "Knowingly relying" means you have +actual knowledge that, but for the patent license, your conveying the +covered work in a country, or your recipient's use of the covered work +in a country, would infringe one or more identifiable patents in that +country that you have reason to believe are valid. + + If, pursuant to or in connection with a single transaction or +arrangement, you convey, or propagate by procuring conveyance of, a +covered work, and grant a patent license to some of the parties +receiving the covered work authorizing them to use, propagate, modify +or convey a specific copy of the covered work, then the patent license +you grant is automatically extended to all recipients of the covered +work and works based on it. + + A patent license is "discriminatory" if it does not include within +the scope of its coverage, prohibits the exercise of, or is +conditioned on the non-exercise of one or more of the rights that are +specifically granted under this License. You may not convey a covered +work if you are a party to an arrangement with a third party that is +in the business of distributing software, under which you make payment +to the third party based on the extent of your activity of conveying +the work, and under which the third party grants, to any of the +parties who would receive the covered work from you, a discriminatory +patent license (a) in connection with copies of the covered work +conveyed by you (or copies made from those copies), or (b) primarily +for and in connection with specific products or compilations that +contain the covered work, unless you entered into that arrangement, +or that patent license was granted, prior to 28 March 2007. + + Nothing in this License shall be construed as excluding or limiting +any implied license or other defenses to infringement that may +otherwise be available to you under applicable patent law. + + 12. No Surrender of Others' Freedom. + + If conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot convey a +covered work so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you may +not convey it at all. For example, if you agree to terms that obligate you +to collect a royalty for further conveying from those to whom you convey +the Program, the only way you could satisfy both those terms and this +License would be to refrain entirely from conveying the Program. + + 13. Remote Network Interaction; Use with the GNU General Public License. + + Notwithstanding any other provision of this License, if you modify the +Program, your modified version must prominently offer all users +interacting with it remotely through a computer network (if your version +supports such interaction) an opportunity to receive the Corresponding +Source of your version by providing access to the Corresponding Source +from a network server at no charge, through some standard or customary +means of facilitating copying of software. This Corresponding Source +shall include the Corresponding Source for any work covered by version 3 +of the GNU General Public License that is incorporated pursuant to the +following paragraph. + + Notwithstanding any other provision of this License, you have +permission to link or combine any covered work with a work licensed +under version 3 of the GNU General Public License into a single +combined work, and to convey the resulting work. The terms of this +License will continue to apply to the part which is the covered work, +but the work with which it is combined will remain governed by version +3 of the GNU General Public License. + + 14. Revised Versions of this License. + + The Free Software Foundation may publish revised and/or new versions of +the GNU Affero General Public License from time to time. Such new versions +will be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + + Each version is given a distinguishing version number. If the +Program specifies that a certain numbered version of the GNU Affero General +Public License "or any later version" applies to it, you have the +option of following the terms and conditions either of that numbered +version or of any later version published by the Free Software +Foundation. If the Program does not specify a version number of the +GNU Affero General Public License, you may choose any version ever published +by the Free Software Foundation. + + If the Program specifies that a proxy can decide which future +versions of the GNU Affero General Public License can be used, that proxy's +public statement of acceptance of a version permanently authorizes you +to choose that version for the Program. + + Later license versions may give you additional or different +permissions. However, no additional obligations are imposed on any +author or copyright holder as a result of your choosing to follow a +later version. + + 15. Disclaimer of Warranty. + + THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY +OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, +THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM +IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF +ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + + 16. Limitation of Liability. + + IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS +THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY +GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE +USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF +DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD +PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), +EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF +SUCH DAMAGES. + + 17. Interpretation of Sections 15 and 16. + + If the disclaimer of warranty and limitation of liability provided +above cannot be given local legal effect according to their terms, +reviewing courts shall apply local law that most closely approximates +an absolute waiver of all civil liability in connection with the +Program, unless a warranty or assumption of liability accompanies a +copy of the Program in return for a fee. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +state the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU Affero General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU Affero General Public License for more details. + + You should have received a copy of the GNU Affero General Public License + along with this program. If not, see . + +Also add information on how to contact you by electronic and paper mail. + + If your software can interact with users remotely through a computer +network, you should also make sure that it provides a way for users to +get its source. For example, if your program is a web application, its +interface could display a "Source" link that leads users to an archive +of the code. There are many ways you could offer source, and different +solutions will be better for different programs; see section 13 for the +specific requirements. + + You should also get your employer (if you work as a programmer) or school, +if any, to sign a "copyright disclaimer" for the program, if necessary. +For more information on this, and how to apply and follow the GNU AGPL, see +. + +========================================================================= + +ADDITIONAL TERMS pursuant to Section 7 of the GNU Affero General Public +License, Version 3 + +The following additional terms apply to the CloudCLI UI project +(https://github.com/siteboon/claudecodeui). These terms are authorized +by Siteboon AI B.V. as copyright holder pursuant to Section 7 of the AGPL-3.0. + +1. Attribution Requirement (Section 7(b)) + + All copies, modified versions, and derivative works of this software + must preserve the following attribution notice in their documentation, + README, or Appropriate Legal Notices: + + "CloudCLI UI (https://github.com/siteboon/claudecodeui)" + + This notice must be reasonably prominent and not hidden in a manner + designed to avoid notice by recipients of the software. + +2. Prohibition of Misrepresentation (Section 7(c)) + + You may not misrepresent the origin of this software. Modified + versions of the software must be clearly and prominently marked as + such, and must not be presented as the original CloudCLI UI software. + +3. Limitation on Publicity (Section 7(d)) + + The names "Siteboon" and "CloudCLI" may not be used for publicity + purposes to endorse or promote products derived from this software + without specific prior written permission from Siteboon AI B.V. + +4. No Trademark Rights (Section 7(e)) + + This License does not grant permission to use the trade names, + trademarks, service marks, or product names "CloudCLI," "CloudCLI UI," + or "Siteboon," except as required for reasonable and customary use in + describing the origin of the work and reproducing the content of the + attribution notice required above. + +========================================================================= + +RELICENSING NOTICE + +Contributions made by Siteboon AI B.V. prior to commit +004135ef0187023e1da29c4a7137a28a42ebf9af (2026-03-28) were originally +published under GPL-3.0. These contributions are hereby relicensed under +AGPL-3.0-or-later by Siteboon AI B.V., as copyright holder. + +Contributions made by other authors prior to the above commit remain +under GPL-3.0 and are incorporated into this AGPL-3.0-or-later work as +permitted by GPL-3.0 Section 13 ("Use with the GNU Affero General Public +License"). + +All new contributions from the above commit onward are licensed under +AGPL-3.0-or-later. diff --git a/NOTICE b/NOTICE new file mode 100644 index 0000000..94ff2ef --- /dev/null +++ b/NOTICE @@ -0,0 +1,13 @@ +CloudCLI UI +Copyright 2025-2026 Siteboon AI B.V. and contributors + +This software is licensed under the GNU Affero General Public License v3.0 +or later (AGPL-3.0-or-later). See the LICENSE file for the full license text, +including additional terms under Section 7. + +Originally developed by Siteboon AI B.V. (https://github.com/siteboon/claudecodeui). + +Contributions by Siteboon AI B.V. prior to commit 004135ef were originally +published under GPL-3.0 and are hereby relicensed to AGPL-3.0-or-later. +Contributions by other authors prior to that commit remain under GPL-3.0 +and are incorporated into this work as permitted by GPL-3.0 Section 13. diff --git a/README.de.md b/README.de.md new file mode 100644 index 0000000..c98af08 --- /dev/null +++ b/README.de.md @@ -0,0 +1,250 @@ +
+ CloudCLI UI +

Cloud CLI (auch bekannt als Claude Code UI)

+

Eine Desktop- und Mobile-Oberfläche für Claude Code, Cursor CLI, Codex und Gemini-CLI.
Lokal oder remote nutzbar – verwalte deine aktiven Projekte und Sitzungen von überall.

+
+ +

+ CloudCLI Cloud · Dokumentation · Discord · Fehler melden · Mitwirken +

+ +

+ CloudCLI Cloud + Join Community +

+ siteboon%2Fclaudecodeui | Trendshift +

+ + + +--- + +## Screenshots + +
+ + + + + + + + + +
+

Desktop-Ansicht

+Desktop-Oberfläche +
+Hauptoberfläche mit Projektübersicht und Chat +		 +

Mobile-Erfahrung

+Mobile-Oberfläche +
+Responsives mobiles Design mit Touch-Navigation +
+

CLI-Auswahl

+CLI-Auswahl +
+Wähle zwischen Claude Code, Gemini, Cursor CLI und Codex +
+ + + +
+ +## Funktionen + +- **Responsives Design** – Funktioniert nahtlos auf Desktop, Tablet und Mobilgerät, sodass du Agents auch vom Smartphone aus nutzen kannst +- **Interaktives Chat-Interface** – Eingebaute Chat-Oberfläche für die reibungslose Kommunikation mit den Agents +- **Integriertes Shell-Terminal** – Direkter Zugriff auf die Agents CLI über die eingebaute Shell-Funktionalität +- **Datei-Explorer** – Interaktiver Dateibaum mit Syntaxhervorhebung und Live-Bearbeitung +- **Git-Explorer** – Änderungen anzeigen, stagen und committen. Branches wechseln ebenfalls möglich +- **Sitzungsverwaltung** – Gespräche fortsetzen, mehrere Sitzungen verwalten und Verlauf nachverfolgen +- **Plugin-System** – CloudCLI mit eigenen Plugins erweitern – neue Tabs, Backend-Dienste und Integrationen hinzufügen. [Eigenes Plugin erstellen →](https://github.com/cloudcli-ai/cloudcli-plugin-starter) +- **TaskMaster AI Integration** *(Optional)* – Erweitertes Projektmanagement mit KI-gestützter Aufgabenplanung, PRD-Parsing und Workflow-Automatisierung +- **Modell-Kompatibilität** – Funktioniert mit Claude, GPT und Gemini (vollständige Liste unterstützter Modelle in [`shared/modelConstants.js`](shared/modelConstants.js)) + + +## Schnellstart + +### CloudCLI Cloud (Empfohlen) + +Der schnellste Einstieg – keine lokale Einrichtung erforderlich. Erhalte eine vollständig verwaltete, containerisierte Entwicklungsumgebung, die über Web, Mobile App, API oder deine bevorzugte IDE erreichbar ist. + +**[Mit CloudCLI Cloud starten](https://cloudcli.ai)** + + +### Self-Hosted (Open Source) + +#### npm + +CloudCLI UI sofort mit **npx** ausprobieren (erfordert **Node.js** v22+): + +```bash +npx @cloudcli-ai/cloudcli +``` + +Oder **global** installieren für regelmäßige Nutzung: + +```bash +npm install -g @cloudcli-ai/cloudcli +cloudcli +``` + +Öffne `http://localhost:3001` – alle vorhandenen Sitzungen werden automatisch erkannt. + +Die **[Dokumentation →](https://cloudcli.ai/docs)** enthält weitere Konfigurationsoptionen, PM2, Remote-Server-Einrichtung und mehr. + +#### Docker Sandboxes (Experimentell) + +Agents in isolierten Sandboxes mit Hypervisor-Isolation ausführen. Standardmäßig wird Claude Code gestartet. Erfordert die [`sbx` CLI](https://docs.docker.com/ai/sandboxes/get-started/). + +``` +npx @cloudcli-ai/cloudcli@latest sandbox ~/my-project +``` + +Unterstützt Claude Code, Codex und Gemini CLI. Weitere Details in der [Sandbox-Dokumentation](docker/). + +--- + +## Welche Option passt zu dir? + +CloudCLI UI ist die Open-Source-UI-Schicht, die CloudCLI Cloud antreibt. Du kannst es auf deinem eigenen Rechner selbst hosten oder CloudCLI Cloud nutzen, das darauf aufbaut und eine vollständig verwaltete Cloud-Umgebung, Team-Funktionen und tiefere Integrationen bietet. + +| | CloudCLI UI (Self-hosted) | CloudCLI Cloud | +|---|---|---| +| **Am besten für** | Entwickler:innen, die eine vollständige UI für lokale Agent-Sitzungen auf ihrem eigenen Rechner möchten | Teams und Entwickler:innen, die Agents in der Cloud betreiben möchten, überall erreichbar | +| **Zugriff** | Browser via `[deineIP]:port` | Browser, jede IDE, REST API, n8n | +| **Einrichtung** | `npx @cloudcli-ai/cloudcli` | Keine Einrichtung erforderlich | +| **Rechner muss laufen** | Ja | Nein | +| **Mobiler Zugriff** | Jeder Browser im Netzwerk | Jedes Gerät, native App in Entwicklung | +| **Verfügbare Sitzungen** | Alle Sitzungen automatisch aus `~/.claude` erkannt | Alle Sitzungen in deiner Cloud-Umgebung | +| **Unterstützte Agents** | Claude Code, Cursor CLI, Codex, Gemini CLI | Claude Code, Cursor CLI, Codex, Gemini CLI | +| **Datei-Explorer und Git** | Ja, direkt in der UI | Ja, direkt in der UI | +| **MCP-Konfiguration** | Über UI verwaltet, synchronisiert mit lokalem `~/.claude` | Über UI verwaltet | +| **IDE-Zugriff** | Deine lokale IDE | Jede IDE, die mit deiner Cloud-Umgebung verbunden ist | +| **REST API** | Ja | Ja | +| **n8n-Node** | Nein | Ja | +| **Team-Sharing** | Nein | Ja | +| **Plattformkosten** | Kostenlos, Open Source | Ab $7/Monat | + +> Beide Optionen verwenden deine eigenen KI-Abonnements (Claude, Cursor usw.) – CloudCLI stellt die Umgebung bereit, nicht die KI. + +--- + +## Sicherheit & Tool-Konfiguration + +**🔒 Wichtiger Hinweis**: Alle Claude Code Tools sind **standardmäßig deaktiviert**. Dies verhindert, dass potenziell schädliche Operationen automatisch ausgeführt werden. + +### Tools aktivieren + +Um den vollen Funktionsumfang von Claude Code zu nutzen, müssen Tools manuell aktiviert werden: + +1. **Tool-Einstellungen öffnen** – Klicke auf das Zahnrad-Symbol in der Seitenleiste +2. **Selektiv aktivieren** – Nur die benötigten Tools einschalten +3. **Einstellungen übernehmen** – Deine Einstellungen werden lokal gespeichert + +
+ +![Tool-Einstellungen Modal](public/screenshots/tools-modal.png) +*Tool-Einstellungen – nur aktivieren, was benötigt wird* + +
+ +**Empfohlene Vorgehensweise**: Mit grundlegenden Tools starten und bei Bedarf weitere hinzufügen. Die Einstellungen können jederzeit angepasst werden. + +--- + +## Plugins + +CloudCLI verfügt über ein Plugin-System, mit dem benutzerdefinierte Tabs mit eigener Frontend-UI und optionalem Node.js-Backend hinzugefügt werden können. Plugins können direkt in **Einstellungen > Plugins** aus Git-Repos installiert oder selbst entwickelt werden. + +### Verfügbare Plugins + +| Plugin | Beschreibung | +|---|---| +| **[Project Stats](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** | Zeigt Dateianzahl, Codezeilen, Dateityp-Aufschlüsselung, größte Dateien und zuletzt geänderte Dateien des aktuellen Projekts | + +### Eigenes Plugin erstellen + +**[Plugin-Starter-Vorlage →](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** – Forke dieses Repository, um ein eigenes Plugin zu erstellen. Es enthält ein funktionierendes Beispiel mit Frontend-Rendering, Live-Kontext-Updates und RPC-Kommunikation zu einem Backend-Server. + +**[Plugin-Dokumentation →](https://cloudcli.ai/docs/plugin-overview)** – Vollständige Anleitung zur Plugin-API, zum Manifest-Format, zum Sicherheitsmodell und mehr. + +--- +## FAQ + +
+Wie unterscheidet sich das von Claude Code Remote Control? + +Claude Code Remote Control ermöglicht es, Nachrichten an eine bereits im lokalen Terminal laufende Sitzung zu senden. Der Rechner muss eingeschaltet bleiben, das Terminal muss offen bleiben, und Sitzungen laufen nach etwa 10 Minuten ohne Netzwerkverbindung ab. + +CloudCLI UI und CloudCLI Cloud erweitern Claude Code, anstatt neben ihm zu laufen – MCP-Server, Berechtigungen, Einstellungen und Sitzungen sind exakt dieselben, die Claude Code nativ verwendet. Nichts wird dupliziert oder separat verwaltet. + +Das bedeutet in der Praxis: + +- **Alle Sitzungen, nicht nur eine** – CloudCLI UI erkennt automatisch jede Sitzung aus dem `~/.claude`-Ordner. Remote Control stellt nur die einzelne aktive Sitzung bereit, um sie in der Claude Mobile App verfügbar zu machen. +- **Deine Einstellungen sind deine Einstellungen** – MCP-Server, Tool-Berechtigungen und Projektkonfiguration, die in CloudCLI UI geändert werden, werden direkt in die Claude Code-Konfiguration geschrieben und treten sofort in Kraft – und umgekehrt. +- **Funktioniert mit mehr Agents** – Claude Code, Cursor CLI, Codex und Gemini CLI, nicht nur Claude Code. +- **Vollständige UI, nicht nur ein Chat-Fenster** – Datei-Explorer, Git-Integration, MCP-Verwaltung und ein Shell-Terminal sind alle eingebaut. +- **CloudCLI Cloud läuft in der Cloud** – Laptop zuklappen, der Agent läuft weiter. Kein Terminal zu überwachen, kein Rechner, der laufen muss. + +
+ +
+Muss ich ein KI-Abonnement separat bezahlen? + +Ja. CloudCLI stellt die Umgebung bereit, nicht die KI. Du bringst dein eigenes Claude-, Cursor-, Codex- oder Gemini-Abonnement mit. CloudCLI Cloud beginnt bei $7/Monat für die gehostete Umgebung zusätzlich dazu. + +
+ +
+Kann ich CloudCLI UI auf meinem Smartphone nutzen? + +Ja. Bei Self-Hosted: Server auf dem eigenen Rechner starten und `[deineIP]:port` in einem beliebigen Browser im Netzwerk öffnen. Bei CloudCLI Cloud: Von jedem Gerät aus öffnen – kein VPN, keine Portweiterleitung, keine Einrichtung. Eine native App ist ebenfalls in Entwicklung. + +
+ +
+Wirken sich Änderungen in der UI auf mein lokales Claude Code-Setup aus? + +Ja, bei Self-Hosted. CloudCLI UI liest aus und schreibt in dieselbe `~/.claude`-Konfiguration, die Claude Code nativ verwendet. MCP-Server, die über die UI hinzugefügt werden, erscheinen sofort in Claude Code und umgekehrt. + +
+ +--- + +## Community & Support + +- **[Dokumentation](https://cloudcli.ai/docs)** — Installation, Konfiguration, Funktionen und Fehlerbehebung +- **[Discord](https://discord.gg/buxwujPNRE)** — Hilfe erhalten und mit anderen Nutzer:innen in Kontakt treten +- **[GitHub Issues](https://github.com/siteboon/claudecodeui/issues)** — Fehlerberichte und Feature-Anfragen +- **[Beitragsrichtlinien](CONTRIBUTING.md)** — So kannst du zum Projekt beitragen + +## Lizenz + +GNU General Public License v3.0 – siehe [LICENSE](LICENSE)-Datei für Details. + +Dieses Projekt ist Open Source und kann unter der GPL v3-Lizenz kostenlos genutzt, modifiziert und verteilt werden. + +## Danksagungen + +### Erstellt mit +- **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** - Anthropics offizielle CLI +- **[Cursor CLI](https://docs.cursor.com/en/cli/overview)** - Cursors offizielle CLI +- **[Codex](https://developers.openai.com/codex)** - OpenAI Codex +- **[Gemini-CLI](https://geminicli.com/)** - Google Gemini CLI +- **[React](https://react.dev/)** - UI-Bibliothek +- **[Vite](https://vitejs.dev/)** - Schnelles Build-Tool und Dev-Server +- **[Tailwind CSS](https://tailwindcss.com/)** - Utility-first CSS-Framework +- **[CodeMirror](https://codemirror.net/)** - Erweiterter Code-Editor +- **[TaskMaster AI](https://github.com/eyaltoledano/claude-task-master)** *(Optional)* - KI-gestütztes Projektmanagement und Aufgabenplanung + + +### Sponsoren +- [Siteboon - KI-gestützter Website-Builder](https://siteboon.ai) +--- + +
+ Mit Sorgfalt für die Claude Code-, Cursor- und Codex-Community erstellt. +
diff --git a/README.ja.md b/README.ja.md new file mode 100644 index 0000000..b5dfdc8 --- /dev/null +++ b/README.ja.md @@ -0,0 +1,242 @@ +
+ CloudCLI UI +

Cloud CLI（別名 Claude Code UI）

+

Claude Code、Cursor CLI、Codex、Gemini-CLI のためのデスクトップ／モバイル UI。
ローカルでもリモートでも使え、アクティブなプロジェクトとセッションをどこからでも閲覧できます。

+
+ +

+ CloudCLI Cloud · ドキュメント · Discord · バグ報告 · コントリビュート +

+ +

+ CloudCLI Cloud + Discord コミュニティに参加 +

+ siteboon%2Fclaudecodeui | Trendshift +

+ + + +--- + +## スクリーンショット + +
+ + + + + + + + + +
+

デスクトップビュー

+デスクトップインターフェース +
+プロジェクト概要とチャットを表示するメイン画面 +		 +

モバイル体験

+モバイルインターフェース +
+タッチ操作に対応したレスポンシブなモバイルデザイン +
+

CLI 選択

+CLI 選択 +
+Claude Code、Gemini、Cursor CLI、Codex から選択 +
+ + + +
+ +## 機能 + +- **レスポンシブデザイン** - デスクトップ／タブレット／モバイルでシームレスに動作し、モバイルからも Agents を利用可能 +- **インタラクティブチャット UI** - Agents とスムーズにやり取りできる内蔵チャット UI +- **統合シェルターミナル** - 内蔵シェル機能で Agents の CLI に直接アクセス +- **ファイルエクスプローラー** - シンタックスハイライトとライブ編集に対応したインタラクティブなファイルツリー +- **Git エクスプローラー** - 変更の表示、ステージ、コミット。ブランチ切り替えも可能 +- **セッション管理** - 会話の再開、複数セッションの管理、履歴の追跡 +- **プラグインシステム** - カスタムプラグインで CloudCLI を拡張 — 新しいタブ、バックエンドサービス、連携を追加できます。[自分で構築する →](https://github.com/cloudcli-ai/cloudcli-plugin-starter) + +## クイックスタート + +### CloudCLI Cloud（推奨） + +最速で始める方法 — ローカルのセットアップは不要です。Web、モバイルアプリ、API、またはお気に入りの IDE からアクセスできる、フルマネージドでコンテナ化された開発環境を利用できます。 + +**[CloudCLI Cloud を始める](https://cloudcli.ai)** + +### セルフホスト（オープンソース） + +#### npm + +**npx** で今すぐ CloudCLI UI を試せます（**Node.js** v22+ が必要）： + +```bash +npx @cloudcli-ai/cloudcli +``` + +または、普段使いするなら **グローバル** にインストール： + +```bash +npm install -g @cloudcli-ai/cloudcli +cloudcli +``` + +`http://localhost:3001` を開いてください — 既存のセッションは自動的に検出されます。 + +より詳細な設定オプション、PM2、リモートサーバー設定などについては **[ドキュメントはこちら →](https://cloudcli.ai/docs)** を参照してください。 + +#### Docker Sandboxes（実験的） + +ハイパーバイザーレベルの分離でエージェントをサンドボックスで実行します。デフォルトでは Claude Code が起動します。[`sbx` CLI](https://docs.docker.com/ai/sandboxes/get-started/) が必要です。 + +``` +npx @cloudcli-ai/cloudcli@latest sandbox ~/my-project +``` + +Claude Code、Codex、Gemini CLI に対応。詳細は[サンドボックスのドキュメント](docker/)をご覧ください。 + +--- + +## どちらの選択肢が適していますか？ + +CloudCLI UI は、CloudCLI Cloud を支えるオープンソースの UI レイヤーです。自分のマシンにセルフホストすることも、フルマネージドのクラウド環境、チーム機能、より深い統合を備えた CloudCLI Cloud を使うこともできます。 + +| | CloudCLI UI（セルフホスト） | CloudCLI Cloud | +|---|---|---| +| **対象ユーザー** | 自分のマシン上でローカルの agent セッションに対してフル UI を使いたい開発者 | クラウド上で動く agents をどこからでも利用したいチーム／開発者 | +| **アクセス方法** | ブラウザ（`[yourip]:port`） | ブラウザ、任意の IDE、REST API、n8n | +| **セットアップ** | `npx @cloudcli-ai/cloudcli` | セットアップ不要 | +| **マシンの稼働継続** | はい | いいえ | +| **モバイルアクセス** | 同一ネットワーク内の任意のブラウザ | 任意のデバイス（ネイティブアプリも準備中） | +| **利用可能なセッション** | `~/.claude` から全セッションを自動検出 | クラウド環境内の全セッション | +| **対応エージェント** | Claude Code、Cursor CLI、Codex、Gemini CLI | Claude Code、Cursor CLI、Codex、Gemini CLI | +| **ファイルエクスプローラとGit** | はい（UI に内蔵） | はい（UI に内蔵） | +| **MCP設定** | UI で管理し、ローカルの `~/.claude` 設定と同期 | UI で管理 | +| **IDEアクセス** | ローカル IDE | クラウド環境に接続された任意の IDE | +| **REST API** | はい | はい | +| **n8n ノード** | いいえ | はい | +| **チーム共有** | いいえ | はい | +| **料金プラン** | 無料（オープンソース） | 月 $7〜 | + +> どちらの選択肢でも、AI のサブスクリプション（Claude、Cursor など）はご自身のものを使用します — CloudCLI が提供するのは環境であり、AI そのものではありません。 + +--- + +## セキュリティとツール設定 + +**🔒 重要なお知らせ** すべての Claude Code ツールは **デフォルトで無効** です。これにより、潜在的に有害な操作が自動的に実行されることを防ぎます。 + +### ツールの有効化 + +1. **ツール設定を開く** - サイドバーの歯車アイコンをクリック +2. **必要なツールだけを選んで有効化** - 本当に使うものだけをオンにする +3. **設定を適用** - 設定内容はローカルに保存されます + +
+ +![ツール設定モーダル](public/screenshots/tools-modal.png) +*Tools 設定画面 - 必要なものだけを有効にしてください* + +
+ +**推奨アプローチ**: まずは基本ツールだけを有効にし、必要に応じて追加してください。これらの設定は後からいつでも調整できます。 + +--- + +## プラグイン + +CloudCLI にはプラグインシステムがあり、独自のフロントエンド UI と（必要に応じて）Node.js バックエンドを持つカスタムタブを追加できます。プラグインは **Settings > Plugins** から git リポジトリを直接指定してインストールするか、自作できます。 + +### 利用可能なプラグイン + +| プラグイン | 説明 | +|---|---| +| **[Project Stats](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** | 現在のプロジェクトについて、ファイル数、コード行数、ファイル種別の内訳、最大ファイル、最近変更されたファイルを表示 | + +### 自作する + +**[Plugin Starter Template →](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** — このリポジトリを fork して独自プラグインを作れます。フロントエンド描画、ライブコンテキスト更新、バックエンドサーバーへの RPC 通信を含む動作例が入っています。 + +**[プラグインのドキュメント →](https://cloudcli.ai/docs/plugin-overview)** — プラグイン API、manifest 形式、セキュリティモデルなどの完全ガイド。 + +--- +## FAQ + +
+Claude Code Remote Control とはどう違いますか？ + +Claude Code Remote Control は、ローカル端末で既に動作しているセッションへメッセージを送れる仕組みです。マシンを起動したままにし、端末も開いたままにする必要があり、ネットワーク接続がない状態が約 10 分続くとセッションがタイムアウトします。 + +CloudCLI UI と CloudCLI Cloud は、Claude Code の横に別物として存在するのではなく、Claude Code を拡張します — MCP サーバー、権限、設定、セッションは Claude Code がネイティブに使うものと完全に同一です。複製したり、別系統で管理したりしません。 + +- **すべてのセッションにアクセス** — CloudCLI UI は `~/.claude` フォルダのすべてのセッションを自動検出します。Remote Control は、Claude モバイルアプリで利用可能にするため、1つのアクティブセッションだけを公開します。 +- **設定はあなたの設定** — CloudCLI UI で変更した MCP サーバー、ツール権限、プロジェクト構成は、Claude Code の設定に直接書き込まれて即座に反映され、その逆（Claude Code での変更が UI に反映）も同様です。 +- **対応エージェントがさらに充実** — Claude Code に加えて Cursor CLI、Codex、Gemini CLI にも対応しています。 +- **チャット窓だけではない完全な UI** — ファイルエクスプローラー、Git 統合、MCP 管理、シェル端末などがすべて組み込まれています。 +- **CloudCLI Cloud はクラウド上で稼働** — ノートパソコンを閉じてもエージェントは動き続けます。監視が要る端末も、スリープ防止も不要です。 + +
+ +
+AI のサブスクリプションは別途支払いが必要ですか？ + +はい。CloudCLI は環境を提供するものであり、AI は含まれません。Claude、Cursor、Codex、または Gemini のサブスクリプションはご自身でご用意ください。CloudCLI Cloud のホスティング環境はそれに加えて月額 $7 から提供されます。 + +
+ +
+CloudCLI UI をスマホで使えますか？ + +はい。セルフホストの場合は、自身のマシンでサーバーを起動し、ネットワーク内のブラウザで `[yourip]:port` を開いてください。CloudCLI Cloud を使う場合は、任意のデバイスからアクセスできます。VPN もポートフォワーディングも不要で、セットアップも不要です。ネイティブアプリも開発中です。 + +
+ +
+UI で加えた変更はローカルの Claude Code 設定に影響しますか？ + +はい、セルフホストの場合です。CloudCLI UI は Claude Code がネイティブに使う `~/.claude` 設定を読み書きします。UI から追加した MCP サーバーは即座に Claude Code に反映され、その逆も同様です。 + +
+ +--- + +## コミュニティとサポート + +- **[ドキュメント](https://cloudcli.ai/docs)** — インストール、設定、機能、トラブルシューティング +- **[Discord](https://discord.gg/buxwujPNRE)** — ヘルプを得たり、ユーザー同士で交流したりできます +- **[GitHub Issues](https://github.com/siteboon/claudecodeui/issues)** — バグ報告と機能要望 +- **[コントリビューションガイド](CONTRIBUTING.md)** — プロジェクトへの貢献方法 + +## ライセンス + +GNU General Public License v3.0 - 詳細は [LICENSE](LICENSE) ファイルを参照してください。 + +このプロジェクトはオープンソースであり、GPL v3 ライセンスの下で無料で使用、修正、再配布できます。 + +## 謝辞 + +### 使用技術 + +- **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** - Anthropic の公式 CLI +- **[Cursor CLI](https://docs.cursor.com/en/cli/overview)** - Cursor の公式 CLI +- **[Codex](https://developers.openai.com/codex)** - OpenAI Codex +- **[Gemini-CLI](https://geminicli.com/)** - Google Gemini CLI +- **[React](https://react.dev/)** - ユーザーインターフェースライブラリ +- **[Vite](https://vitejs.dev/)** - 高速ビルドツールと開発サーバー +- **[Tailwind CSS](https://tailwindcss.com/)** - ユーティリティファーストの CSS フレームワーク +- **[CodeMirror](https://codemirror.net/)** - 高度なコードエディタ +- **[TaskMaster AI](https://github.com/eyaltoledano/claude-task-master)** *(オプション)* - AI を活用したプロジェクト管理とタスク計画 + +## スポンサー +- [Siteboon - AI を活用したウェブサイトビルダー](https://siteboon.ai) +--- + +
+ Claude Code、Cursor、Codex コミュニティのために心を込めて作りました。 +
diff --git a/README.ko.md b/README.ko.md new file mode 100644 index 0000000..b5cf5a9 --- /dev/null +++ b/README.ko.md @@ -0,0 +1,242 @@ +
+ CloudCLI UI +

Cloud CLI (일명 Claude Code UI)

+

Claude Code, Cursor CLI, Codex, Gemini-CLI 용 데스크톱 및 모바일 UI입니다.
로컬 또는 원격에서 실행하여 어디서나 활성 프로젝트와 세션을 확인하세요.

+
+ +

+ CloudCLI Cloud · 문서 · Discord · 버그 신고 · 기여 안내 +

+ +

+ CloudCLI Cloud + Discord 커뮤니티 +

+ siteboon%2Fclaudecodeui | Trendshift +

+ + + +--- + +## 스크린샷 + +
+ + + + + + + + + +
+

데스크톱 보기

+데스크톱 인터페이스 +
+프로젝트 개요와 채팅을 보여주는 메인 인터페이스 +		 +

모바일 경험

+모바일 인터페이스 +
+터치 내비게이션이 포함된 반응형 모바일 디자인 +
+

CLI 선택

+CLI 선택 +
+Claude Code, Gemini, Cursor CLI 및 Codex 중 선택 +
+ +
+ +## 기능 + +- **반응형 디자인** - 데스크톱, 태블릿, 모바일을 아우르는 매끄러운 경험으로 어디서든 Agents를 사용할 수 있습니다 +- **대화형 채팅 인터페이스** - 내장된 채팅 UI를 통해 에이전트와 자연스럽게 소통 +- **통합 셸 터미널** - 셸 기능을 통해 Agents CLI에 직접 접근 +- **파일 탐색기** - 구문 강조 및 실시간 편집을 갖춘 인터랙티브 파일 트리 +- **Git 탐색기** - 변경 사항 보기, 스테이징 및 커밋. 브랜치 전환 기능 포함 +- **세션 관리** - 대화를 재개하고, 여러 세션을 관리하며 기록을 추적 +- **플러그인 시스템** - 커스텀 탭, 백엔드 서비스, 통합을 추가하여 CloudCLI 확장. [직접 빌드 →](https://github.com/cloudcli-ai/cloudcli-plugin-starter) +- **TaskMaster AI 통합** *(선택사항)* - AI 중심의 작업 계획, PRD 파싱, 워크플로 자동화를 통한 고급 프로젝트 관리 +- **모델 호환성** - Claude, GPT, Gemini 모델 계열에서 작동 (`shared/modelConstants.js`에서 전체 지원 모델 확인) + +## 빠른 시작 + +### CloudCLI Cloud (추천) + +가장 빠르게 시작하는 방법 — 로컬 설정 없이도 가능합니다. 웹, 모바일 앱, API 또는 선호하는 IDE에서 이용할 수 있는 완전 관리형 컨테이너화된 개발 환경을 제공합니다. + +**[CloudCLI Cloud 시작하기](https://cloudcli.ai)** + +### 셀프 호스트 (오픈 소스) + +#### npm + +**npx**로 즉시 CloudCLI UI를 실행하세요 (Node.js v22+ 필요): + +```bash +npx @cloudcli-ai/cloudcli +``` + +**정기적으로 사용한다면 전역 설치:** + +```bash +npm install -g @cloudcli-ai/cloudcli +cloudcli +``` + +`http://localhost:3001`을 열면 기존 세션이 자동으로 발견됩니다. + +자세한 구성 옵션, PM2, 원격 서버 설정 등은 **[문서 →](https://cloudcli.ai/docs)**를 참고하세요. + +#### Docker Sandboxes (실험적) + +하이퍼바이저 수준 격리로 에이전트를 샌드박스에서 실행합니다. 기본 에이전트는 Claude Code입니다. [`sbx` CLI](https://docs.docker.com/ai/sandboxes/get-started/)가 필요합니다. + +``` +npx @cloudcli-ai/cloudcli@latest sandbox ~/my-project +``` + +Claude Code, Codex, Gemini CLI를 지원합니다. 자세한 내용은 [샌드박스 문서](docker/)를 참고하세요. + +--- + +## 어느 옵션이 적합한가요? + +CloudCLI UI는 CloudCLI Cloud를 구동하는 오픈 소스 UI 계층입니다. 로컬 머신에서 직접 셀프 호스트하거나, CloudCLI Cloud(완전 관리형 클라우드 환경, 팀 기능, 심화 통합 제공)를 사용할 수 있습니다. + +| | CloudCLI UI (셀프 호스트) | CloudCLI Cloud | +|---|---|---| +| **적합한 대상** | 로컬 에이전트 세션을 위한 전체 UI가 필요한 개발자 | 어디서든 접근 가능한 클라우드에서 에이전트를 운영하고자 하는 팀 및 개발자 | +| **접근 방법** | `[yourip]:port`를 통해 브라우저 접속 | 브라우저, IDE, REST API, n8n | +| **설정** | `npx @cloudcli-ai/cloudcli` | 설정 불필요 | +| **기기 유지 필요 여부** | 예 (머신 켜둬야 함) | 아니오 | +| **모바일 접근** | 네트워크 내 브라우저 | 모든 기기 (네이티브 앱 예정) | +| **세션 접근** | `~/.claude`에서 자동 발견 | 클라우드 환경 내 세션 | +| **지원 에이전트** | Claude Code, Cursor CLI, Codex, Gemini CLI | Claude Code, Cursor CLI, Codex, Gemini CLI | +| **파일 탐색기 및 Git** | UI에 통합됨 | UI에 통합됨 | +| **MCP 구성** | UI에서 관리, 로컬 `~/.claude` 설정과 동기화됨 | UI에서 관리 | +| **IDE 접근** | 로컬 IDE | 클라우드 환경에 연결된 모든 IDE | +| **REST API** | 예 | 예 | +| **n8n 노드** | 아니오 | 예 | +| **팀 공유** | 아니오 | 예 | +| **플랫폼 비용** | 무료, 오픈 소스 | 월 $7부터 | + +> 둘 다 자체 AI 구독(Claude, Cursor 등)을 그대로 사용합니다 — CloudCLI는 환경만 제공합니다. + +--- + +## 보안 및 도구 구성 + +**🔒 중요 공지**: 모든 Claude Code 도구는 **기본적으로 비활성화**되어 있습니다. 이는 잠재적인 유해 작업이 자동 실행되는 것을 방지하기 위한 조치입니다. + +### 도구 활성화 + +1. **도구 설정 열기** - 사이드바의 톱니바퀴 아이콘 클릭 +2. **선택적으로 활성화** - 필요한 도구만 켜기 +3. **설정 적용** - 선호도는 로컬에 저장됨 + +
+ +![도구 설정 모달](public/screenshots/tools-modal.png) +*도구 설정 인터페이스 - 필요한 것만 켜세요* + +
+ +**권장 방법**: 기본 도구를 먼저 켜고 필요할 때 추가하세요. 언제든지 조정 가능합니다. + +--- + +## 플러그인 + +CloudCLI는 커스텀 탭과 선택적 Node.js 백엔드가 포함된 플러그인 시스템을 제공합니다. Settings > Plugins에서 Git 저장소에서 플러그인을 설치하거나 직접 빌드할 수 있습니다. + +### 이용 가능한 플러그인 + +| 플러그인 | 설명 | +|---|---| +| **[Project Stats](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** | 현재 프로젝트의 파일 수, 코드 줄 수, 파일 유형 분포, 가장 큰 파일, 최근 수정 파일을 표시 | + +### 직접 만들기 + +**[Plugin Starter Template →](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** — 이 저장소를 포크하여 플러그인 구축. 프런트엔드 렌더링, 실시간 컨텍스트 업데이트, RPC 통신 예제 포함. + +**[플러그인 문서 →](https://cloudcli.ai/docs/plugin-overview)** — 플러그인 API, 매니페스트 포맷, 보안 모델 등을 설명. + +--- + +## FAQ + +
+Claude Code Remote Control과 어떻게 다른가요? + +Claude Code Remote Control은 이미 로컬 터미널에서 실행 중인 세션으로 메시지를 전송합니다. 이 경우 기계가 켜져 있어야 하고 터미널을 열어 둬야 하며, 네트워크 연결 없이 약 10분 후 타임아웃됩니다. + +CloudCLI UI와 CloudCLI Cloud는 Claude Code를 확장하며 별도로 존재하지 않습니다 — MCP 서버, 권한, 설정, 세션은 Claude Code에서 그대로 사용됩니다. + +- **모든 세션을 다룬다** — CloudCLI UI는 `~/.claude` 폴더에서 모든 세션을 자동 발견합니다. Remote Control은 단일 활성 세션만 노출합니다. +- **설정은 그대로** — CloudCLI UI에서 변경한 MCP, 도구 권한, 프로젝트 설정은 Claude Code에 즉시 반영됩니다. +- **지원 에이전트가 더 많음** — Claude Code, Cursor CLI, Codex, Gemini CLI 지원. +- **전체 UI 제공** — 단일 채팅 창이 아닌 파일 탐색기, Git 통합, MCP 관리 및 셸 터미널 포함. +- **CloudCLI Cloud는 클라우드에서 실행** — 노트북을 닫아도 에이전트가 실행됩니다. 터미널을 계속 확인할 필요 없음. + +
+ +
+AI 구독을 별도로 결제해야 하나요? + +네. CloudCLI는 환경만 제공합니다. Claude, Cursor, Codex, Gemini 구독 비용은 별도로 부과됩니다. CloudCLI Cloud는 관리형 환경을 월 $7부터 제공합니다. + +
+ +
+CloudCLI UI를 휴대폰에서 사용할 수 있나요? + +네. 셀프 호스트인 경우 기계에서 서버를 실행하고 네트워크의 아무 브라우저에서 `[yourip]:port`를 열면 됩니다. CloudCLI Cloud는 어떤 기기에서도 열 수 있으며, 네이티브 앱도 준비 중입니다. + +
+ +
+UI에서 변경하면 로컬 Claude Code 설정에 영향을 주나요? + +네, 셀프 호스트에서는 그렇습니다. CloudCLI UI는 Claude Code가 사용하는 동일한 `~/.claude` 설정을 읽고 씁니다. UI에서 추가한 MCP 서버가 Claude Code에 즉시 나타납니다. + +
+ +--- + +## 커뮤니티 및 지원 + +- **[문서](https://cloudcli.ai/docs)** — 설치, 구성, 기능, 문제 해결 안내 +- **[Discord](https://discord.gg/buxwujPNRE)** — 도움 및 커뮤니티 참여 +- **[GitHub Issues](https://github.com/siteboon/claudecodeui/issues)** — 버그 보고 및 기능 요청 +- **[기여 안내](CONTRIBUTING.md)** — 프로젝트 참여 방법 + +## 라이선스 + +GNU General Public License v3.0 - 자세한 내용은 [LICENSE](LICENSE) 파일 참조. + +이 프로젝트는 GPL v3 라이선스 하에 오픈 소스로 공개되어 있으며 자유롭게 사용, 수정, 배포할 수 있습니다. + +## 감사의 말 + +### 사용 기술 +- **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** - Anthropic 공식 CLI +- **[Cursor CLI](https://docs.cursor.com/en/cli/overview)** - Cursor 공식 CLI +- **[Codex](https://developers.openai.com/codex)** - OpenAI Codex +- **[Gemini-CLI](https://geminicli.com/)** - Google Gemini CLI +- **[React](https://react.dev/)** - 사용자 인터페이스 라이브러리 +- **[Vite](https://vitejs.dev/)** - 빠른 빌드 도구 및 개발 서버 +- **[Tailwind CSS](https://tailwindcss.com/)** - 유틸리티 우선 CSS 프레임워크 +- **[CodeMirror](https://codemirror.net/)** - 고급 코드 에디터 +- **[TaskMaster AI](https://github.com/eyaltoledano/claude-task-master)** *(선택사항)* - AI 기반 프로젝트 관리 및 작업 계획 + +### 스폰서 +- [Siteboon - AI powered website builder](https://siteboon.ai) +--- + +
+ Claude Code, Cursor, Codex 커뮤니티를 위해 정성껏 제작되었습니다. +
diff --git a/README.md b/README.md new file mode 100644 index 0000000..ae95b03 --- /dev/null +++ b/README.md @@ -0,0 +1,252 @@ +
+ CloudCLI UI +

Cloud CLI (aka Claude Code UI)

+

A desktop and mobile UI for Claude Code, Cursor CLI, Codex, and Gemini-CLI.
Use it locally or remotely to view your active projects and sessions from everywhere.

+
+ +

+ CloudCLI Cloud · Documentation · Discord · Bug Reports · Contributing +

+ +

+ CloudCLI Cloud + Join our Discord +

+ siteboon%2Fclaudecodeui | Trendshift +

+ + + +--- + +## Screenshots + +
+ + + + + + + + + +
+

Desktop View

+Desktop Interface +
+Main interface showing project overview and chat +		 +

Mobile Experience

+Mobile Interface +
+Responsive mobile design with touch navigation +
+

CLI Selection

+CLI Selection +
+Select between Claude Code, Gemini, Cursor CLI and Codex +
+ + + +
+ +## Features + +- **Responsive Design** - Works seamlessly across desktop, tablet, and mobile so you can also use Agents from mobile +- **Interactive Chat Interface** - Built-in chat interface for seamless communication with the Agents +- **Integrated Shell Terminal** - Direct access to the Agents CLI through built-in shell functionality +- **File Explorer** - Interactive file tree with syntax highlighting and live editing +- **Git Explorer** - View, stage and commit your changes. You can also switch branches +- **Session Management** - Resume conversations, manage multiple sessions, and track history +- **Plugin System** - Extend CloudCLI with custom plugins — add new tabs, backend services, and integrations. [Build your own →](https://github.com/cloudcli-ai/cloudcli-plugin-starter) +- **TaskMaster AI Integration** *(Optional)* - Advanced project management with AI-powered task planning, PRD parsing, and workflow automation +- **Model Compatibility** - Works with Claude, GPT, and Gemini model families (see [`shared/modelConstants.js`](shared/modelConstants.js) for the full list of supported models) + + +## Quick Start + +### CloudCLI Cloud (Recommended) + +The fastest way to get started — no local setup required. Get a fully managed, containerized development environment accessible from the web, mobile app, API, or your favorite IDE. + +**[Get started with CloudCLI Cloud](https://cloudcli.ai)** + + +### Self-Hosted (Open source) + +#### npm + +Try CloudCLI UI instantly with **npx** (requires **Node.js** v22+): + +``` +npx @cloudcli-ai/cloudcli +``` + +Or install **globally** for regular use: + +``` +npm install -g @cloudcli-ai/cloudcli +cloudcli +``` + +Open `http://localhost:3001` — all your existing sessions are discovered automatically. + +Visit the **[documentation →](https://cloudcli.ai/docs)** for full configuration options, PM2, remote server setup and more. + +#### Docker Sandboxes (Experimental) + +Run agents in isolated sandboxes with hypervisor-level isolation. Starts Claude Code by default. Requires the [`sbx` CLI](https://docs.docker.com/ai/sandboxes/get-started/). + +``` +npx @cloudcli-ai/cloudcli@latest sandbox ~/my-project +``` + +Supports Claude Code, Codex, and Gemini CLI. See the [sandbox docs](docker/) for setup and advanced options. + + +--- + +## Which option is right for you? + +CloudCLI UI is the open source UI layer that powers CloudCLI Cloud. You can self-host it on your own machine, run it in a Docker sandbox for isolation, or use CloudCLI Cloud for a fully managed environment. + +| | Self-Hosted (npm) | Self-Hosted (Docker Sandbox) *(Experimental)* | CloudCLI Cloud | +|---|---|---|---| +| **Best for** | Local agent sessions on your own machine | Isolated agents with web/mobile IDE | Teams who want agents in the cloud | +| **How you access it** | Browser via `[yourip]:port` | Browser via `localhost:port` | Browser, any IDE, REST API, n8n | +| **Setup** | `npx @cloudcli-ai/cloudcli` | `npx @cloudcli-ai/cloudcli@latest sandbox ~/project` | No setup required | +| **Isolation** | Runs on your host | Hypervisor-level sandbox (microVM) | Full cloud isolation | +| **Machine needs to stay on** | Yes | Yes | No | +| **Mobile access** | Any browser on your network | Any browser on your network | Any device, native app coming | +| **Agents supported** | Claude Code, Cursor CLI, Codex, Gemini CLI | Claude Code, Codex, Gemini CLI | Claude Code, Cursor CLI, Codex, Gemini CLI | +| **File explorer and Git** | Yes | Yes | Yes | +| **MCP configuration** | Synced with `~/.claude` | Managed via UI | Managed via UI | +| **REST API** | Yes | Yes | Yes | +| **Team sharing** | No | No | Yes | +| **Platform cost** | Free, open source | Free, open source | Starts at $7/month | + +> All options use your own AI subscriptions (Claude, Cursor, etc.) — CloudCLI provides the environment, not the AI. + +--- + +## Security & Tools Configuration + +**🔒 Important Notice**: All Claude Code tools are **disabled by default**. This prevents potentially harmful operations from running automatically. + +### Enabling Tools + +To use Claude Code's full functionality, you'll need to manually enable tools: + +1. **Open Tools Settings** - Click the gear icon in the sidebar +2. **Enable Selectively** - Turn on only the tools you need +3. **Apply Settings** - Your preferences are saved locally + +
+ +![Tools Settings Modal](public/screenshots/tools-modal.png) +*Tools Settings interface - enable only what you need* + +
+ +**Recommended approach**: Start with basic tools enabled and add more as needed. You can always adjust these settings later. + +--- + +## Plugins + +CloudCLI has a plugin system that lets you add custom tabs with their own frontend UI and optional Node.js backend. Install plugins from git repos directly in **Settings > Plugins**, or build your own. + +### Available Plugins + +| Plugin | Description | +|---|---| +| **[Project Stats](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** | Shows file counts, lines of code, file-type breakdown, largest files, and recently modified files for your current project | +| **[Web Terminal](https://github.com/cloudcli-ai/cloudcli-plugin-terminal)** | Full xterm.js terminal with multi-tab support| +| **[CloudCLI Scheduler](https://github.com/grostim/cloudcli-cron)** | Create workspace-scoped scheduled prompts and execute them through a local CLI such as Codex, Claude Code, or Gemini CLI| +### Build Your Own + +**[Plugin Starter Template →](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** — fork this repo to create your own plugin. It includes a working example with frontend rendering, live context updates, and RPC communication to a backend server. + +**[Plugin Documentation →](https://cloudcli.ai/docs/plugin-overview)** — full guide to the plugin API, manifest format, security model, and more. + +--- +## FAQ + +
+How is this different from Claude Code Remote Control? + +Claude Code Remote Control lets you send messages to a session already running in your local terminal. Your machine has to stay on, your terminal has to stay open, and sessions time out after roughly 10 minutes without a network connection. + +CloudCLI UI and CloudCLI Cloud extend Claude Code rather than sit alongside it — your MCP servers, permissions, settings, and sessions are the exact same ones Claude Code uses natively. Nothing is duplicated or managed separately. + +Here's what that means in practice: + +- **All your sessions, not just one** — CloudCLI UI auto-discovers every session from your `~/.claude` folder. Remote Control only exposes the single active session to make it available in the Claude mobile app. +- **Your settings are your settings** — MCP servers, tool permissions, and project config you change in CloudCLI UI are written directly to your Claude Code config and take effect immediately, and vice versa. +- **Works with more agents** — Claude Code, Cursor CLI, Codex, and Gemini CLI, not just Claude Code. +- **Full UI, not just a chat window** — file explorer, Git integration, MCP management, and a shell terminal are all built in. +- **CloudCLI Cloud runs in the cloud** — close your laptop, the agent keeps running. No terminal to babysit, no machine to keep awake. + +
+ +
+Do I need to pay for an AI subscription separately? + +Yes. CloudCLI provides the environment, not the AI. You bring your own Claude, Cursor, Codex, or Gemini subscription. CloudCLI Cloud starts at $7/month for the hosted environment on top of that. + +
+ +
+Can I use CloudCLI UI on my phone? + +Yes. For self-hosted, run the server on your machine and open `[yourip]:port` in any browser on your network. For CloudCLI Cloud, open it from any device — no VPN, no port forwarding, no setup. A native app is also in the works. + +
+ +
+Will changes I make in the UI affect my local Claude Code setup? + +Yes, for self-hosted. CloudCLI UI reads from and writes to the same `~/.claude` config that Claude Code uses natively. MCP servers you add via the UI show up in Claude Code immediately and vice versa. + +
+ +--- + +## Community & Support + +- **[Documentation](https://cloudcli.ai/docs)** — installation, configuration, features, and troubleshooting +- **[Discord](https://discord.gg/buxwujPNRE)** — get help and connect with other users +- **[GitHub Issues](https://github.com/siteboon/claudecodeui/issues)** — bug reports and feature requests +- **[Contributing Guide](CONTRIBUTING.md)** — how to contribute to the project + +## License + +GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later) — see [LICENSE](LICENSE) for the full text, including additional terms under Section 7. + +This project is open source and free to use, modify, and distribute under the AGPL-3.0-or-later license. If you modify this software and run it as a network service, you must make your modified source code available to users of that service. + +CloudCLI UI - (https://cloudcli.ai). + +## Acknowledgments + +### Built With +- **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** - Anthropic's official CLI +- **[Cursor CLI](https://docs.cursor.com/en/cli/overview)** - Cursor's official CLI +- **[Codex](https://developers.openai.com/codex)** - OpenAI Codex +- **[Gemini-CLI](https://geminicli.com/)** - Google Gemini CLI +- **[React](https://react.dev/)** - User interface library +- **[Vite](https://vitejs.dev/)** - Fast build tool and dev server +- **[Tailwind CSS](https://tailwindcss.com/)** - Utility-first CSS framework +- **[CodeMirror](https://codemirror.net/)** - Advanced code editor +- **[TaskMaster AI](https://github.com/eyaltoledano/claude-task-master)** *(Optional)* - AI-powered project management and task planning + + +### Sponsors +- [Siteboon - AI powered website builder](https://siteboon.ai) +--- + +
+ Made with care for the Claude Code, Cursor and Codex community. +
diff --git a/README.ru.md b/README.ru.md new file mode 100644 index 0000000..c197676 --- /dev/null +++ b/README.ru.md @@ -0,0 +1,250 @@ +
+ CloudCLI UI +

Cloud CLI (aka Claude Code UI)

+

Десктопный и мобильный UI для Claude Code, Cursor CLI, Codex и Gemini-CLI.
Используйте локально или удалённо, чтобы просматривать активные проекты и сессии отовсюду.

+
+ +

+ CloudCLI Cloud · Документация · Discord · Сообщить об ошибке · Участие в разработке +

+ +

+ CloudCLI Cloud + Join our Discord +

+ siteboon%2Fclaudecodeui | Trendshift +

+ +
English · Русский · Deutsch · 한국어 · 中文 · 日本語 · Türkçe
+ +--- + +## Скриншоты + +
+ + + + + + + + + +
+

Версия для десктопа

+Desktop Interface +
+Основной интерфейс с обзором проекта и чатом +		 +

Мобильный режим

+Mobile Interface +
+Адаптивный мобильный дизайн с сенсорной навигацией +
+

Выбор CLI

+CLI Selection +
+Выбирайте между Claude Code, Gemini, Cursor CLI и Codex +
+ + + +
+ +## Возможности + +- **Адаптивный дизайн** - одинаково хорошо работает на десктопе, планшете и телефоне, поэтому можно пользоваться агентами и с мобильных устройств +- **Интерактивный чат-интерфейс** - встроенный чат для бесшовного общения с агентами +- **Интегрированный shell-терминал** - прямой доступ к CLI агентов через встроенную оболочку +- **Проводник файлов** - интерактивное дерево файлов с подсветкой синтаксиса и редактированием в реальном времени +- **Git Explorer** - просмотр, stage и commit изменений. Также можно переключать ветки +- **Управление сессиями** - возобновляйте диалоги, управляйте несколькими сессиями и отслеживайте историю +- **Система плагинов** - расширяйте CloudCLI кастомными плагинами — добавляйте новые вкладки, бэкенд-сервисы и интеграции. [Создать свой →](https://github.com/cloudcli-ai/cloudcli-plugin-starter) +- **Интеграция с TaskMaster AI** *(опционально)* - продвинутое управление проектами с планированием задач на базе AI, разбором PRD и автоматизацией workflow +- **Совместимость с моделями** - работает с семействами моделей Claude, GPT и Gemini (см. [`shared/modelConstants.js`](shared/modelConstants.js) для полного списка поддерживаемых моделей) + + +## Быстрый старт + +### CloudCLI Cloud (рекомендуется) + +Самый быстрый способ начать — локальная настройка не требуется. Получите полностью управляемую контейнеризированную среду разработки с доступом из веба, мобильного приложения, API или вашей любимой IDE. + +**[Начать с CloudCLI Cloud](https://cloudcli.ai)** + + +### Self-Hosted (Open source) + +#### npm + +Попробовать CloudCLI UI можно сразу через **npx** (требуется **Node.js** v22+): + +```bash +npx @cloudcli-ai/cloudcli +``` + +Или установить **глобально** для регулярного использования: + +```bash +npm install -g @cloudcli-ai/cloudcli +cloudcli +``` + +Откройте `http://localhost:3001` — все ваши существующие сессии будут обнаружены автоматически. + +Посетите **[документацию →](https://cloudcli.ai/docs)**, чтобы узнать про дополнительные варианты конфигурации, PM2, настройку удалённого сервера и многое другое. + +#### Docker Sandboxes (Экспериментально) + +Запускайте агентов в изолированных песочницах с гипервизорной изоляцией. По умолчанию запускается Claude Code. Требуется [`sbx` CLI](https://docs.docker.com/ai/sandboxes/get-started/). + +``` +npx @cloudcli-ai/cloudcli@latest sandbox ~/my-project +``` + +Поддерживаются Claude Code, Codex и Gemini CLI. Подробнее в [документации sandbox](docker/). + +--- + +## Какой вариант подходит вам? + +CloudCLI UI — это open source UI-слой, на котором построен CloudCLI Cloud. Вы можете развернуть его на своей машине или использовать CloudCLI Cloud, который добавляет полностью управляемую облачную среду, командные функции и более глубокие интеграции. + +| | CloudCLI UI (Self-hosted) | CloudCLI Cloud | +|---|---|---| +| **Лучше всего подходит для** | Разработчиков, которым нужен полноценный UI для локальных агентских сессий на своей машине | Команд и разработчиков, которым нужны агенты в облаке с доступом откуда угодно | +| **Как вы получаете доступ** | Браузер через `[yourip]:port` | Браузер, любая IDE, REST API, n8n | +| **Настройка** | `npx @cloudcli-ai/cloudcli` | Настройка не требуется | +| **Машина должна оставаться включённой** | Да | Нет | +| **Доступ с мобильных устройств** | Любой браузер в вашей сети | Любое устройство, нативное приложение в разработке | +| **Доступные сессии** | Все сессии автоматически обнаруживаются из `~/.claude` | Все сессии внутри вашей облачной среды | +| **Поддерживаемые агенты** | Claude Code, Cursor CLI, Codex, Gemini CLI | Claude Code, Cursor CLI, Codex, Gemini CLI | +| **Проводник файлов и Git** | Да, встроены в UI | Да, встроены в UI | +| **Конфигурация MCP** | Управляется через UI, синхронизируется с вашим локальным конфигом `~/.claude` | Управляется через UI | +| **Доступ из IDE** | Ваша локальная IDE | Любая IDE, подключенная к вашей облачной среде | +| **REST API** | Да | Да | +| **n8n node** | Нет | Да | +| **Совместная работа** | Нет | Да | +| **Стоимость платформы** | Бесплатно, open source | От $7/месяц | + +> В обоих вариантах используются ваши собственные AI-подписки (Claude, Cursor и т.д.) — CloudCLI предоставляет среду, а не сам AI. + +--- + +## Безопасность и конфигурация инструментов + +**🔒 Важное примечание**: все инструменты Claude Code **по умолчанию отключены**. Это предотвращает автоматический запуск потенциально опасных операций. + +### Включение инструментов + +Чтобы использовать всю функциональность Claude Code, вам нужно вручную включить инструменты: + +1. **Откройте настройки инструментов** - нажмите на иконку шестерёнки в боковой панели +2. **Включайте выборочно** - активируйте только те инструменты, которые вам нужны +3. **Примените настройки** - ваши предпочтения сохраняются локально + +
+ +![Tools Settings Modal](public/screenshots/tools-modal.png) +*Интерфейс настройки инструментов — включайте только то, что вам нужно* + +
+ +**Рекомендуемый подход**: начните с базовых инструментов и добавляйте остальные по мере необходимости. Эти настройки всегда можно изменить позже. + +--- + +## Плагины + +У CloudCLI есть система плагинов, которая позволяет добавлять кастомные вкладки со своим frontend UI и (опционально) Node.js бэкендом. Устанавливайте плагины напрямую из git-репозиториев в **Settings > Plugins** или создавайте свои. + +### Доступные плагины + +| Плагин | Описание | +|---|---| +| **[Project Stats](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** | Показывает количество файлов, строки кода, разбивку по типам файлов, самые большие файлы и недавно изменённые файлы для текущего проекта | + +### Создать свой + +**[Plugin Starter Template →](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** — сделайте форк этого репозитория, чтобы создать свой плагин. В шаблоне есть рабочий пример с рендерингом на фронтенде, live-обновлением контекста и RPC-коммуникацией с бэкенд-сервером. + +**[Plugin Documentation →](https://cloudcli.ai/docs/plugin-overview)** — полный гайд по plugin API, формату манифеста, модели безопасности и другому. + +--- +## FAQ + +
+Чем это отличается от Claude Code Remote Control? + +Claude Code Remote Control позволяет отправлять сообщения в сессию, которая уже запущена в вашем локальном терминале. Ваша машина должна оставаться включённой, терминал — открытым, а сессии завершаются примерно через 10 минут без сетевого соединения. + +CloudCLI UI и CloudCLI Cloud расширяют Claude Code, а не работают рядом с ним — ваши MCP-серверы, разрешения, настройки и сессии остаются теми же самыми, что и в нативном Claude Code. Ничего не дублируется и не управляется отдельно. + +Вот что это означает на практике: + +- **Все ваши сессии, а не одна** — CloudCLI UI автоматически находит каждую сессию из папки `~/.claude`. Remote Control предоставляет только одну активную сессию, чтобы сделать её доступной в мобильном приложении Claude. +- **Ваши настройки — это ваши настройки** — MCP-серверы, права инструментов и конфигурация проекта, изменённые в CloudCLI UI, записываются напрямую в конфиг Claude Code и вступают в силу сразу же, и наоборот. +- **Работает с большим числом агентов** — Claude Code, Cursor CLI, Codex и Gemini CLI, а не только Claude Code. +- **Полноценный UI, а не просто окно чата** — проводник файлов, Git-интеграция, управление MCP и shell-терминал — всё встроено. +- **CloudCLI Cloud работает в облаке** — закройте ноутбук, и агент продолжит работать. Не нужно следить за терминалом и держать машину постоянно активной. + +
+ +
+Нужно ли отдельно платить за AI-подписку? + +Да. CloudCLI предоставляет среду, а не сам AI. Вы приносите свою подписку Claude, Cursor, Codex или Gemini. CloudCLI Cloud начинается от $7/месяц за хостируемую среду поверх этого. + +
+ +
+Можно ли пользоваться CloudCLI UI с телефона? + +Да. Для self-hosted запустите сервер на своей машине и откройте `[yourip]:port` в любом браузере в вашей сети. Для CloudCLI Cloud откройте сервис с любого устройства — без VPN, проброса портов и дополнительной настройки. Нативное приложение тоже в разработке. + +
+ +
+Повлияют ли изменения, сделанные в UI, на мой локальный Claude Code? + +Да, в self-hosted режиме. CloudCLI UI читает и записывает тот же конфиг `~/.claude`, который Claude Code использует нативно. MCP-серверы, добавленные через UI, сразу появляются в Claude Code, и наоборот. + +
+ +--- + +## Сообщество и поддержка + +- **[Документация](https://cloudcli.ai/docs)** — установка, настройка, возможности и устранение неполадок +- **[Discord](https://discord.gg/buxwujPNRE)** — помощь и общение с другими пользователями +- **[GitHub Issues](https://github.com/siteboon/claudecodeui/issues)** — сообщения об ошибках и запросы новых функций +- **[Руководство для контрибьюторов](CONTRIBUTING.md)** — как участвовать в развитии проекта + +## Лицензия + +GNU General Public License v3.0 - подробности в файле [LICENSE](LICENSE). + +Этот проект open source и бесплатен для использования, модификации и распространения в рамках лицензии GPL v3. + +## Благодарности + +### Используется +- **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** - официальный CLI от Anthropic +- **[Cursor CLI](https://docs.cursor.com/en/cli/overview)** - официальный CLI от Cursor +- **[Codex](https://developers.openai.com/codex)** - OpenAI Codex +- **[Gemini-CLI](https://geminicli.com/)** - Google Gemini CLI +- **[React](https://react.dev/)** - библиотека пользовательских интерфейсов +- **[Vite](https://vitejs.dev/)** - быстрый инструмент сборки и dev-сервер +- **[Tailwind CSS](https://tailwindcss.com/)** - utility-first CSS framework +- **[CodeMirror](https://codemirror.net/)** - продвинутый редактор кода +- **[TaskMaster AI](https://github.com/eyaltoledano/claude-task-master)** *(опционально)* - AI-управление проектами и планирование задач + + +### Спонсоры +- [Siteboon - AI powered website builder](https://siteboon.ai) +--- + +
+ Сделано с заботой для сообщества Claude Code, Cursor и Codex. +
diff --git a/README.tr.md b/README.tr.md new file mode 100644 index 0000000..a0bcdf5 --- /dev/null +++ b/README.tr.md @@ -0,0 +1,252 @@ +
+ CloudCLI UI +

Cloud CLI (Claude Code UI olarak da bilinir)

+

Claude Code, Cursor CLI, Codex ve Gemini-CLI için masaüstü ve mobil arayüz.
Yerel ya da uzaktan kullanarak aktif projelerine ve oturumlarına her yerden erişebilirsin.

+
+ +

+ CloudCLI Cloud · Dokümantasyon · Discord · Sorun Bildir · Katkıda Bulun +

+ +

+ CloudCLI Cloud + Discord'a Katıl +

+ siteboon%2Fclaudecodeui | Trendshift +

+ + + +--- + +## Ekran Görüntüleri + +
+ + + + + + + + + +
+

Masaüstü Görünümü

+Masaüstü Arayüzü +
+Proje genel bakışı ve sohbeti gösteren ana arayüz +		 +

Mobil Deneyim

+Mobil Arayüz +
+Dokunma gezinmesiyle duyarlı mobil tasarım +
+

CLI Seçimi

+CLI Seçimi +
+Claude Code, Gemini, Cursor CLI ve Codex arasında seçim yap +
+ + + +
+ +## Özellikler + +- **Duyarlı Tasarım** — Masaüstü, tablet ve mobilde sorunsuz çalışır; böylece ajanlarını telefondan da kullanabilirsin +- **Etkileşimli Sohbet Arayüzü** — Ajanlarla akıcı iletişim için dahili sohbet arayüzü +- **Entegre Shell Terminali** — Yerleşik shell özelliği üzerinden ajan CLI'larına doğrudan erişim +- **Dosya Gezgini** — Sözdizimi vurgulama ve canlı düzenleme ile etkileşimli dosya ağacı +- **Git Gezgini** — Değişikliklerini görüntüle, staging'e ekle ve commit'le. Dallar arası geçiş de yapabilirsin +- **Oturum Yönetimi** — Konuşmalara devam et, birden fazla oturumu yönet ve geçmişi takip et +- **Eklenti Sistemi** — CloudCLI'ı özel eklentilerle genişlet: yeni sekmeler, arka uç servisleri ve entegrasyonlar ekle. [Kendi eklentini yaz →](https://github.com/cloudcli-ai/cloudcli-plugin-starter) +- **TaskMaster AI Entegrasyonu** *(İsteğe Bağlı)* — AI destekli görev planlama, PRD ayrıştırma ve iş akışı otomasyonu ile gelişmiş proje yönetimi +- **Model Uyumluluğu** — Claude, GPT ve Gemini model aileleriyle çalışır (desteklenen tüm modeller için [`shared/modelConstants.js`](shared/modelConstants.js) dosyasına bak) + + +## Hızlı Başlangıç + +### CloudCLI Cloud (Önerilen) + +Başlamanın en hızlı yolu — yerel kurulum yok. Web, mobil uygulama, API veya favori IDE'nden erişilebilen, tam yönetilen, konteyner tabanlı bir geliştirme ortamına sahip ol. + +**[CloudCLI Cloud ile başla](https://cloudcli.ai)** + + +### Kendin Barındır (Açık Kaynak) + +#### npm + +CloudCLI UI'yi **npx** ile anında dene (**Node.js** v22+ gerekir): + +``` +npx @cloudcli-ai/cloudcli +``` + +Veya düzenli kullanım için **genel olarak** kur: + +``` +npm install -g @cloudcli-ai/cloudcli +cloudcli +``` + +`http://localhost:3001` adresini aç — mevcut tüm oturumların otomatik olarak keşfedilir. + +Tam yapılandırma seçenekleri, PM2, uzak sunucu kurulumu ve daha fazlası için **[dokümantasyonu ziyaret et →](https://cloudcli.ai/docs)**. + +#### Docker Sandbox'lar (Deneysel) + +Ajanları hipervizör seviyesinde izolasyonlu sandbox'larda çalıştır. Varsayılan olarak Claude Code başlar. [`sbx` CLI](https://docs.docker.com/ai/sandboxes/get-started/) gerekir. + +``` +npx @cloudcli-ai/cloudcli@latest sandbox ~/my-project +``` + +Claude Code, Codex ve Gemini CLI destekler. Kurulum ve gelişmiş seçenekler için [sandbox dokümantasyonuna](docker/) bak. + + +--- + +## Hangi seçenek sana uygun? + +CloudCLI UI, CloudCLI Cloud'u güçlendiren açık kaynak arayüz katmanıdır. Kendi makinende barındırabilir, izolasyon için Docker sandbox'ta çalıştırabilir veya tam yönetilen ortam için CloudCLI Cloud kullanabilirsin. + +| | Kendin Barındır (npm) | Kendin Barındır (Docker Sandbox) *(Deneysel)* | CloudCLI Cloud | +|---|---|---|---| +| **En iyi şunun için** | Kendi makinende yerel ajan oturumları | Web/mobil IDE ile izole ajanlar | Ajanlarını bulutta isteyen ekipler | +| **Nasıl erişilir** | `[yourip]:port` üzerinden tarayıcıda | `localhost:port` üzerinden tarayıcıda | Tarayıcı, herhangi bir IDE, REST API, n8n | +| **Kurulum** | `npx @cloudcli-ai/cloudcli` | `npx @cloudcli-ai/cloudcli@latest sandbox ~/project` | Kurulum gerekmez | +| **İzolasyon** | Kendi host'unda çalışır | Hipervizör seviyesi sandbox (microVM) | Tam bulut izolasyonu | +| **Makinenin açık kalması gerek** | Evet | Evet | Hayır | +| **Mobil erişim** | Ağındaki herhangi bir tarayıcı | Ağındaki herhangi bir tarayıcı | Herhangi bir cihaz, native uygulama yolda | +| **Desteklenen ajanlar** | Claude Code, Cursor CLI, Codex, Gemini CLI | Claude Code, Codex, Gemini CLI | Claude Code, Cursor CLI, Codex, Gemini CLI | +| **Dosya gezgini ve Git** | Evet | Evet | Evet | +| **MCP yapılandırması** | `~/.claude` ile senkron | UI üzerinden yönetilir | UI üzerinden yönetilir | +| **REST API** | Evet | Evet | Evet | +| **Ekip paylaşımı** | Hayır | Hayır | Evet | +| **Platform maliyeti** | Ücretsiz, açık kaynak | Ücretsiz, açık kaynak | Aylık 7 $'dan başlar | + +> Tüm seçenekler kendi AI aboneliklerini (Claude, Cursor, vb.) kullanır — CloudCLI AI'ı değil, ortamı sağlar. + +--- + +## Güvenlik ve Araç Yapılandırması + +**🔒 Önemli Uyarı**: Tüm Claude Code araçları **varsayılan olarak devre dışıdır**. Bu, potansiyel olarak zararlı işlemlerin otomatik çalışmasını önler. + +### Araçları Etkinleştirme + +Claude Code'un tam işlevselliğinden yararlanmak için araçları manuel olarak etkinleştirmen gerekir: + +1. **Araç Ayarlarını Aç** — Kenar çubuğundaki dişli simgesine tıkla +2. **Seçerek Etkinleştir** — Yalnızca ihtiyacın olan araçları aç +3. **Ayarları Uygula** — Tercihlerin yerel olarak kaydedilir + +
+ +![Araç Ayarları Modalı](public/screenshots/tools-modal.png) +*Araç Ayarları arayüzü — yalnızca ihtiyacın olanı etkinleştir* + +
+ +**Önerilen yaklaşım**: Temel araçlarla başla ve gerektikçe daha fazlasını ekle. Bu ayarları sonra her zaman değiştirebilirsin. + +--- + +## Eklentiler + +CloudCLI, kendi frontend UI'sı ve isteğe bağlı Node.js arka ucu olan özel sekmeler eklemeni sağlayan bir eklenti sistemine sahiptir. Git depolarından eklentileri doğrudan **Ayarlar > Eklentiler**'den yükleyebilir veya kendi eklentini yazabilirsin. + +### Mevcut Eklentiler + +| Eklenti | Açıklama | +|---|---| +| **[Project Stats](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** | Mevcut projen için dosya sayıları, kod satırları, dosya türü dağılımı, en büyük dosyalar ve son değiştirilen dosyaları gösterir | +| **[Web Terminal](https://github.com/cloudcli-ai/cloudcli-plugin-terminal)** | Çoklu sekme destekli tam xterm.js terminali | + +### Kendi Eklentini Yaz + +**[Plugin Starter Şablonu →](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** — kendi eklentini oluşturmak için bu repo'yu fork'la. Frontend render, canlı bağlam güncellemeleri ve arka uç sunucusuyla RPC iletişimi içeren çalışan bir örnek içerir. + +**[Plugin Dokümantasyonu →](https://cloudcli.ai/docs/plugin-overview)** — plugin API'sı, manifest formatı, güvenlik modeli ve daha fazlası için tam rehber. + +--- +## Sık Sorulan Sorular + +
+Bu Claude Code Remote Control'dan nasıl farklı? + +Claude Code Remote Control, yerel terminalinde zaten çalışan bir oturuma mesaj göndermeni sağlar. Makinen açık kalmak zorunda, terminalin açık kalmak zorunda ve ağ bağlantısı olmadan yaklaşık 10 dakika sonra oturumlar zaman aşımına uğrar. + +CloudCLI UI ve CloudCLI Cloud, Claude Code'un yanında değil içinde çalışır — MCP sunucuların, izinlerin, ayarların ve oturumların, Claude Code'un yerel olarak kullandığının birebir aynısıdır. Hiçbir şey çoğaltılmaz veya ayrı yönetilmez. + +Pratikte bu ne demek: + +- **Tek oturum değil, tüm oturumların** — CloudCLI UI, `~/.claude` klasöründeki her oturumu otomatik keşfeder. Remote Control yalnızca tek aktif oturumu Claude mobil uygulamasına açar. +- **Ayarların sana ait** — UI'da değiştirdiğin MCP sunucuları, araç izinleri ve proje yapılandırması doğrudan Claude Code yapılandırmana yazılır ve anında etkili olur; tersi de geçerli. +- **Daha fazla ajanla çalışır** — Sadece Claude Code değil; Cursor CLI, Codex ve Gemini CLI de. +- **Sadece sohbet penceresi değil, tam UI** — dosya gezgini, Git entegrasyonu, MCP yönetimi ve shell terminali hepsi yerleşik. +- **CloudCLI Cloud bulutta çalışır** — laptop'unu kapat, ajan çalışmaya devam eder. Beklemen gereken terminal yok, uyanık tutman gereken makine yok. + +
+ +
+AI aboneliği için ayrıca ödeme yapmam gerekiyor mu? + +Evet. CloudCLI AI'yi değil, ortamı sağlar. Kendi Claude, Cursor, Codex veya Gemini aboneliğini getirirsin. CloudCLI Cloud, barındırılan ortam için aylık 7 $'dan başlar — bunun üzerine eklenir. + +
+ +
+CloudCLI UI'yi telefonumda kullanabilir miyim? + +Evet. Kendin barındırdığında, sunucuyu makinende çalıştır ve ağındaki herhangi bir tarayıcıda `[yourip]:port` adresini aç. CloudCLI Cloud için, herhangi bir cihazdan aç — VPN yok, port yönlendirme yok, kurulum yok. Native bir uygulama da hazırlanıyor. + +
+ +
+UI'da yaptığım değişiklikler yerel Claude Code kurulumumu etkiler mi? + +Evet, kendin barındırdığında. CloudCLI UI, Claude Code'un yerel olarak kullandığı aynı `~/.claude` yapılandırmasından okur ve ona yazar. UI üzerinden eklediğin MCP sunucuları Claude Code'da anında görünür; tersi de geçerli. + +
+ +--- + +## Topluluk ve Destek + +- **[Dokümantasyon](https://cloudcli.ai/docs)** — kurulum, yapılandırma, özellikler ve sorun giderme +- **[Discord](https://discord.gg/buxwujPNRE)** — yardım al ve diğer kullanıcılarla tanış +- **[GitHub Issues](https://github.com/siteboon/claudecodeui/issues)** — hata raporları ve özellik istekleri +- **[Katkı Rehberi](CONTRIBUTING.md)** — projeye nasıl katkıda bulunulur + +## Lisans + +GNU Affero General Public License v3.0 veya sonrası (AGPL-3.0-or-later) — tam metin ve Bölüm 7 altındaki ek şartlar için [LICENSE](LICENSE) dosyasına bak. + +Bu proje açık kaynaklıdır ve AGPL-3.0-or-later lisansı altında özgürce kullanılabilir, değiştirilebilir ve dağıtılabilir. Bu yazılımı değiştirir ve bir ağ servisi olarak çalıştırırsan, değiştirilmiş kaynak kodunu o servisin kullanıcılarına sunmak zorundasın. + +CloudCLI UI — (https://cloudcli.ai). + +## Teşekkürler + +### Kullanılan Teknolojiler +- **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** — Anthropic'in resmi CLI'ı +- **[Cursor CLI](https://docs.cursor.com/en/cli/overview)** — Cursor'un resmi CLI'ı +- **[Codex](https://developers.openai.com/codex)** — OpenAI Codex +- **[Gemini-CLI](https://geminicli.com/)** — Google Gemini CLI +- **[React](https://react.dev/)** — Kullanıcı arayüzü kütüphanesi +- **[Vite](https://vitejs.dev/)** — Hızlı derleme aracı ve geliştirme sunucusu +- **[Tailwind CSS](https://tailwindcss.com/)** — Utility-first CSS framework +- **[CodeMirror](https://codemirror.net/)** — Gelişmiş kod editörü +- **[TaskMaster AI](https://github.com/eyaltoledano/claude-task-master)** *(İsteğe Bağlı)* — AI destekli proje yönetimi ve görev planlama + + +### Sponsorlar +- [Siteboon — AI destekli web sitesi oluşturucu](https://siteboon.ai) +--- + +
+ Claude Code, Cursor ve Codex topluluğu için özenle yapıldı. +
diff --git a/README.zh-CN.md b/README.zh-CN.md new file mode 100644 index 0000000..3e6ced3 --- /dev/null +++ b/README.zh-CN.md @@ -0,0 +1,242 @@ +
+ CloudCLI UI +

Cloud CLI（又名 Claude Code UI）

+

Claude Code、Cursor CLI、Codex 和 Gemini-CLI 的桌面和移动端 UI。可在本地或远程使用，从任何地方查看激活的项目与会话。

+
+ +

+ CloudCLI Cloud · 文档 · Discord · Bug 报告 · 贡献指南 +

+ +

+ CloudCLI Cloud + 加入 Discord 社区 +

+ siteboon%2Fclaudecodeui | Trendshift +

+ + + +--- + +## 截图 + +
+ + + + + + + + + +
+

桌面视图

+桌面界面 +
+显示项目概览和聊天的主界面 +		 +

移动体验

+移动界面 +
+具有触控导航的响应式移动设计 +
+

CLI 选择

+CLI 选择 +
+在 Claude Code、Gemini、Cursor CLI 与 Codex 之间进行选择 +
+ +
+ +## 功能 + +- **响应式设计** - 在桌面、平板和移动设备上无缝运行，让您随时随地使用 Agents +- **交互聊天界面** - 内置聊天 UI，轻松与 Agents 交流 +- **集成 Shell 终端** - 通过内置 shell 功能直接访问 Agents CLI +- **文件浏览器** - 交互式文件树，支持语法高亮与实时编辑 +- **Git 浏览器** - 查看、暂存并提交更改，还可切换分支 +- **会话管理** - 恢复对话、管理多个会话并跟踪历史记录 +- **插件系统** - 通过自定义选项卡、后端服务与集成扩展 CloudCLI。 [开始构建 →](https://github.com/cloudcli-ai/cloudcli-plugin-starter) +- **TaskMaster AI 集成** *(可选)* - 结合 AI 任务规划、PRD 分析与工作流自动化，实现高级项目管理 +- **模型兼容性** - 支持 Claude、GPT、Gemini 模型家族（完整支持列表见 [`shared/modelConstants.js`](shared/modelConstants.js)） + +## 快速开始 + +### CloudCLI Cloud（推荐） + +无需本地设置即可快速启动。提供可通过网络浏览器、移动应用、API 或喜欢的 IDE 访问的完全集装式托管开发环境。 + +**[立即开始 CloudCLI Cloud](https://cloudcli.ai)** + +### 自托管（开源） + +#### npm + +启动 CloudCLI UI，只需一行 `npx`（需要 Node.js v22+）： + +```bash +npx @cloudcli-ai/cloudcli +``` + +或进行全局安装，便于日常使用： + +```bash +npm install -g @cloudcli-ai/cloudcli +cloudcli +``` + +打开 `http://localhost:3001`，系统会自动发现所有现有会话。 + +更多配置选项、PM2、远程服务器设置等，请参阅 **[文档 →](https://cloudcli.ai/docs)**。 + +#### Docker Sandboxes（实验性） + +在隔离的沙箱中运行代理，具有虚拟机管理程序级别的隔离。默认启动 Claude Code。需要 [`sbx` CLI](https://docs.docker.com/ai/sandboxes/get-started/)。 + +``` +npx @cloudcli-ai/cloudcli@latest sandbox ~/my-project +``` + +支持 Claude Code、Codex 和 Gemini CLI。详情请参阅 [沙箱文档](docker/)。 + +--- + +## 哪个选项更适合你？ + +CloudCLI UI 是 CloudCLI Cloud 的开源 UI 层。你可以在本地机器上自托管它，也可以使用提供团队功能与深入集成的 CloudCLI Cloud。 + +| | CloudCLI UI（自托管） | CloudCLI Cloud | +|---|---|---| +| **适合对象** | 需要为本地代理会话提供完整 UI 的开发者 | 需要部署在云端，随时从任何地方访问代理的团队与开发者 | +| **访问方式** | 通过 `[yourip]:port` 在浏览器中访问 | 浏览器、任意 IDE、REST API、n8n | +| **设置** | `npx @cloudcli-ai/cloudcli` | 无需设置 | +| **机器需保持开机吗** | 是 | 否 | +| **移动端访问** | 网络内任意浏览器 | 任意设备（原生应用即将推出） | +| **可用会话** | 自动发现 `~/.claude` 中的所有会话 | 云端环境内的会话 | +| **支持的 Agents** | Claude Code、Cursor CLI、Codex、Gemini CLI | Claude Code、Cursor CLI、Codex、Gemini CLI | +| **文件浏览与 Git** | 内置于 UI | 内置于 UI | +| **MCP 配置** | UI 管理，与本地 `~/.claude` 配置同步 | UI 管理 | +| **IDE 访问** | 本地 IDE | 任何连接到云环境的 IDE | +| **REST API** | 是 | 是 | +| **n8n 节点** | 否 | 是 | +| **团队共享** | 否 | 是 | +| **平台费用** | 免费开源 | 起价 $7/月 | + +> 两种方式都使用你自己的 AI 订阅（Claude、Cursor 等）— CloudCLI 提供环境，而非 AI。 + +--- + +## 安全与工具配置 + +**🔒 重要提示**: 所有 Claude Code 工具默认**禁用**，可防止潜在的有害操作自动运行。 + +### 启用工具 + +1. **打开工具设置** - 点击侧边栏齿轮图标 +2. **选择性启用** - 仅启用所需工具 +3. **应用设置** - 偏好设置保存在本地 + +
+ +![工具设置弹窗](public/screenshots/tools-modal.png) +*工具设置界面 - 只启用你需要的内容* + +
+ +**推荐做法**: 先启用基础工具，再根据需要添加其他工具。随时可以调整。 + +--- + +## 插件 + +CloudCLI 配备插件系统，允许你添加带自定义前端 UI 和可选 Node.js 后端的选项卡。在 Settings > Plugins 中直接从 Git 仓库安装插件，或自行开发。 + +### 可用插件 + +| 插件 | 描述 | +|---|---| +| **[Project Stats](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** | 展示当前项目的文件数、代码行数、文件类型分布、最大文件以及最近修改的文件 | + +### 自行构建 + +**[Plugin Starter Template →](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** — Fork 该仓库以构建自己的插件。示例包括前端渲染、实时上下文更新和 RPC 通信。 + +**[插件文档 →](https://cloudcli.ai/docs/plugin-overview)** — 提供插件 API、清单格式、安全模型等完整指南。 + +--- + +## 常见问题 + +
+与 Claude Code Remote Control 有何不同？ + +Claude Code Remote Control 让你发送消息到本地终端中已经运行的会话。该方式要求你的机器保持开机，终端保持开启，断开网络后约 10 分钟会话会超时。 + +CloudCLI UI 与 CloudCLI Cloud 是对 Claude Code 的扩展，而非旁观 — MCP 服务器、权限、设置、会话与 Claude Code 完全一致。 + +- **覆盖全部会话** — CloudCLI UI 会自动扫描 `~/.claude` 文件夹中的每个会话。Remote Control 只暴露当前活动的会话。 +- **设置统一** — 在 CloudCLI UI 中修改的 MCP、工具权限等设置会立即写入 Claude Code。 +- **支持更多 Agents** — Claude Code、Cursor CLI、Codex、Gemini CLI。 +- **完整 UI** — 除了聊天界面，还包括文件浏览器、Git 集成、MCP 管理和 Shell 终端。 +- **CloudCLI Cloud 保持运行于云端** — 关闭本地设备也不会中断代理运行，无需监控终端。 + +
+ +
+需要额外购买 AI 订阅吗？ + +需要。CloudCLI 只提供环境。你仍需自行获取 Claude、Cursor、Codex 或 Gemini 订阅。CloudCLI Cloud 从 $7/月起提供托管环境。 + +
+ +
+能在手机上使用 CloudCLI UI 吗？ + +可以。自托管时，在你的设备上运行服务器，然后在网络中的任意浏览器打开 `[yourip]:port`。CloudCLI Cloud 可从任意设备访问，内置原生应用也在开发中。 + +
+ +
+UI 中的更改会影响本地 Claude Code 配置吗？ + +会的。自托管模式下，CloudCLI UI 读取并写入 Claude Code 使用的 `~/.claude` 配置。通过 UI 添加的 MCP 服务器会立即在 Claude Code 中可见。 + +
+ +--- + +## 社区与支持 + +- **[文档](https://cloudcli.ai/docs)** — 安装、配置、功能与故障排除指南 +- **[Discord](https://discord.gg/buxwujPNRE)** — 获取帮助并与社区交流 +- **[GitHub Issues](https://github.com/siteboon/claudecodeui/issues)** — 报告 Bug 与建议功能 +- **[贡献指南](CONTRIBUTING.md)** — 如何参与项目贡献 + +## 许可证 + +GNU 通用公共许可证 v3.0 - 详见 [LICENSE](LICENSE) 文件。 + +该项目为开源软件，在 GPL v3 许可证下可自由使用、修改与分发。 + +## 致谢 + +### 使用技术 +- **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** - Anthropic 官方 CLI +- **[Cursor CLI](https://docs.cursor.com/en/cli/overview)** - Cursor 官方 CLI +- **[Codex](https://developers.openai.com/codex)** - OpenAI Codex +- **[Gemini-CLI](https://geminicli.com/)** - Google Gemini CLI +- **[React](https://react.dev/)** - 用户界面库 +- **[Vite](https://vitejs.dev/)** - 快速构建工具与开发服务器 +- **[Tailwind CSS](https://tailwindcss.com/)** - 实用先行 CSS 框架 +- **[CodeMirror](https://codemirror.net/)** - 高级代码编辑器 +- **[TaskMaster AI](https://github.com/eyaltoledano/claude-task-master)** *(可选)* - AI 驱动的项目管理与任务规划 + +### 赞助商 +- [Siteboon - AI powered website builder](https://siteboon.ai) +--- + +
+ 为 Claude Code、Cursor 和 Codex 社区精心打造。 +
diff --git a/claude-data/backups/.claude.json.backup.1779576385831 b/claude-data/backups/.claude.json.backup.1779576385831 new file mode 100644 index 0000000..6349e31 --- /dev/null +++ b/claude-data/backups/.claude.json.backup.1779576385831 @@ -0,0 +1,646 @@ +{ + "numStartups": 23, + "tipsHistory": { + "new-user-warmup": 1, + "plan-mode-for-complex-tasks": 2, + "color-when-multi-clauding": 3, + "terminal-setup": 7, + "memory-command": 7, + "theme-command": 10, + "status-line": 15, + "prompt-queue": 16, + "enter-to-steer-in-relatime": 16, + "todo-list": 17, + "install-github-app": 18, + "install-slack-app": 22, + "permissions": 22, + "drag-and-drop-images": 23 + }, + "promptQueueUseCount": 4, + "btwUseCount": 1, + "cachedGrowthBookFeatures": { + "tengu_ccr_post_turn_summary": false, + "tengu_ochre_hollow": false, + "tengu_ultraplan_config": { + "enabled": true + }, + "tengu_cinder_plover": "", + "tengu_fg_left_arrow_agents": false, + "claude_code_skills_dashboard_enabled_cli": false, + "tengu_amber_redwood2": "", + "tengu_timber_lark": "copy_a", + "tengu_disable_bypass_permissions_mode": false, + "tengu_kairos_input_needed_push": true, + "tengu_snippet_save": false, + "tengu_auto_mode_default_on": false, + "tengu_basalt_spur": false, + "tengu_copper_fox": false, + "tengu_olive_hinge": "", + "tengu_orchid_trellis": false, + "tengu_gypsum_kite": false, + "tengu_bg_attach_stall_ms": 5000, + "tengu_sessions_elevated_auth_enforcement": false, + "tengu_kestrel_arch": "OFF", + "tengu_velvet_ibis": {}, + "tengu_velvet_cascade": {}, + "tengu_classifier_summary_heuristic_emit": false, + "tengu_ember_latch": true, + "tengu_cedar_inlet": "off", + "tengu_loud_sugary_rock": false, + "tengu_quiet_basalt_echo": false, + "tengu_marble_sandcastle": false, + "tengu_willow_sentinel_ttl_hours": 1, + "tengu_pewter_summit": true, + "tengu_bramble_lintel": 7, + "tengu_max_version_config": {}, + "tengu_copper_bridge": true, + "tengu_amber_prism": true, + "tengu_flint_harbor": false, + "tengu_canary": {}, + "tengu_mcp_elicitation": true, + "tengu_trace_lantern": false, + "tengu_turtle_carbon": true, + "tengu_amber_sentinel": true, + "tengu_cobalt_ridge": true, + "tengu_fennel_kite_model": "", + "tengu_shining_fractals": false, + "tengu_bridge_attestation_enforce": false, + "tengu_sm_config": { + "minimumMessageTokensToInit": 150000, + "minimumTokensBetweenUpdate": 40000, + "toolCallsBetweenUpdates": 10 + }, + "tengu_immediate_model_command": false, + "tengu_doorbell_agave": false, + "tengu_nimble_amber_prose": false, + "tengu-top-of-feed-tip": { + "tip": "", + "color": "" + }, + "tengu_slate_harrier": "off", + "tengu_version_config": { + "minVersion": "1.0.24" + }, + "tengu_tussock_oriole": false, + "tengu_ccr_bridge_multi_session": true, + "tengu_sub_nomdrep_q7k": true, + "tengu_hazel_osprey_floor": 75000, + "tengu_hazel_osprey": false, + "tengu_amber_lark": false, + "tengu_slate_siskin": { + "enabled": false, + "timeoutMs": 8000, + "throttleMs": 30000, + "summaryLineThreshold": 5 + }, + "tengu_marble_lark": false, + "tengu_claudeai_mcp_connectors": true, + "tengu_kairos_loop_prompt": true, + "tengu_agent_list_attach": false, + "tengu_kairos_push_notifications": true, + "tengu_jade_anvil_4": false, + "tengu_mcp_retry_failed_remote": false, + "tengu_review_bughunter_config": { + "fleet_size": 5, + "max_duration_minutes": 10, + "agent_timeout_seconds": 600, + "total_wallclock_minutes": 22, + "model": "claude-opus-4-7", + "cost_note": "$5-$25", + "duration_note": "~5-10 min", + "enabled": true + }, + "tengu_compact_cache_prefix": true, + "tengu_passport_quail": false, + "tengu_onyx_plover": { + "enabled": false, + "minHours": 24, + "minSessions": 3, + "remoteEnabled": false + }, + "tengu_amber_rokovoko": 0.2, + "tengu_quiet_harbor": false, + "tengu_penguin_mode_promo": { + "discountPercent": 0, + "endDate": "Feb 16" + }, + "tengu_coral_fern": false, + "tengu_shale_finch": true, + "tengu_vellum_lantern": false, + "tengu_session_memory": false, + "tengu_vscode_onboarding": false, + "tengu_ccr_bundle_max_bytes": 104857600, + "tengu_bridge_requires_action_details": true, + "tengu_desktop_upsell_v2": { + "enabled": false + }, + "tengu_c4w_usage_limit_notifications_enabled": true, + "tengu_desktop_upsell": { + "enable_shortcut_tip": true, + "enable_startup_dialog": false + }, + "tengu_slate_finch": false, + "tengu_birch_compass": true, + "tengu_file_write_optimization": true, + "tengu_steady_lantern": false, + "tengu_anchor_tide": false, + "tengu_chert_bezel": true, + "tengu_sparrow_ledger": false, + "tengu_gouda_loop": true, + "tengu_auto_notice_once": true, + "tengu_crimson_echo": {}, + "tengu_skills_dashboard_enabled": false, + "tengu_classifier_summary_llm_emit": false, + "tengu_tool_pear": false, + "tengu_slate_meadow": true, + "tengu_orchid_mantis_v2": true, + "tengu_flint_harbor_share": true, + "tengu_ccr_v2_send_events_cli": false, + "tengu_code_diff_cli": true, + "tengu_pewter_brook": false, + "tengu_marble_whisper2": true, + "tengu_slate_harbor_experiment": false, + "tengu_amber_heron": false, + "tengu_prompt_cache_diagnostics": true, + "tengu_cobalt_wren": false, + "tengu_willow_refresh_ttl_hours": 0, + "tengu_sedge_lantern": true, + "tengu_gha_plugin_code_review": false, + "tengu_mcp_subagent_prompt": true, + "tengu_plank_river_frost": "user_intent", + "tengu_fennel_kite": false, + "tengu_lichen_compass": false, + "tengu_scratch": false, + "tengu_slate_thimble": false, + "tengu_scarf_coffee": false, + "tengu_collage_kaleidoscope": true, + "tengu_feature_template": false, + "tengu_drift_lantern": false, + "tengu_cedar_halo": false, + "tengu_amber_flint": true, + "tengu_lapis_finch": true, + "tengu_cinder_almanac": true, + "tengu_event_sampling_config": {}, + "tengu_surreal_dali": true, + "tengu_walrus_canteen": false, + "tengu_streaming_tool_execution2": true, + "tengu_system_prompt_global_cache": true, + "tengu_mocha_barista": true, + "tengu_slate_wren": false, + "tengu_hawthorn_steeple": false, + "tengu_moth_copse": false, + "tengu_frond_boric": {}, + "tengu_amber_anchor": false, + "tengu_swann_brevity": "focused", + "tengu_workflows_enabled": false, + "tengu_harbor": true, + "tengu_umber_petrel": false, + "tengu_bridge_repl_v2_config": { + "init_retry_max_attempts": 3, + "init_retry_base_delay_ms": 500, + "init_retry_jitter_fraction": 0.25, + "init_retry_max_delay_ms": 4000, + "http_timeout_ms": 10000, + "uuid_dedup_buffer_size": 2000, + "heartbeat_interval_ms": 20000, + "heartbeat_jitter_fraction": 0.1, + "token_refresh_buffer_ms": 600000, + "teardown_archive_timeout_ms": 1500, + "connect_timeout_ms": 15000, + "min_version": "2.1.70", + "should_show_app_upgrade_message": false + }, + "tengu_cork_lantern": false, + "tengu_bridge_poll_interval_ms": 0, + "tengu_penguins_enabled": true, + "tengu_tern_alloy": "copy_a", + "tengu_sage_compass": {}, + "tengu_crystal_beam": { + "budgetTokens": 0 + }, + "tengu_willow_mode": "hint_v2", + "tengu_ultraplan_timeout_seconds": 5400, + "tengu_otk_slot_v1": false, + "tengu_ultraplan_prompt_identifier": "visual_plan", + "tengu_billiard_aviary": false, + "tengu_cobalt_compass": true, + "tengu_cobalt_raccoon": true, + "tengu_ccr_bridge": true, + "tengu_marble_anvil": true, + "tengu_pewter_ledger": "OFF", + "tengu_sepia_cormorant": [], + "tengu_kairos_cron": true, + "tengu_fgts": true, + "tengu_ember_trail": "0", + "tengu_orford_ness": false, + "tengu_cork_m4q": true, + "tengu_pewter_kestrel": { + "global": 50000, + "Bash": 30000, + "PowerShell": 30000, + "Grep": 20000, + "Snip": 1000, + "StrReplaceBasedEditTool": 30000, + "BashSearchTool": 20000 + }, + "tengu_read_dedup_killswitch": false, + "tengu_tool_search_unsupported_models": [ + "haiku" + ], + "tengu_kairos_loop_dynamic": true, + "tengu_birthday_hat": false, + "tengu_plugin_official_mkt_git_fallback": true, + "tengu_post_compact_survey": false, + "tengu_ladder_mq7": false, + "tengu_react_vulnerability_warning": false, + "tengu_negative_interaction_transcript_ask_config": { + "probability": 0 + }, + "tengu_crimson_vector": false, + "tengu_bad_survey_transcript_ask_config": { + "probability": 1 + }, + "tengu_sedge_lantern_holdback": false, + "tengu_bridge_poll_interval_config": { + "poll_interval_ms_not_at_capacity": 2000, + "poll_interval_ms_at_capacity": 600000, + "heartbeat_interval_ms": 0, + "multisession_poll_interval_ms_not_at_capacity": 5000, + "multisession_poll_interval_ms_at_capacity": 60000, + "multisession_poll_interval_ms_partial_capacity": 5000, + "non_exclusive_heartbeat_interval_ms": 180000, + "session_keepalive_interval_ms": 0, + "session_keepalive_interval_v2_ms": 0 + }, + "tengu_loggia_carousel": false, + "tengu_1p_event_batch_config": { + "scheduledDelayMillis": 10000, + "maxExportBatchSize": 400, + "maxQueueSize": 8192, + "path": "/api/event_logging/v2/batch" + }, + "tengu_willow_census_ttl_hours": 24, + "tengu_bridge_min_version": { + "minVersion": "2.1.70" + }, + "tengu_prism_ledger": false, + "tengu_mcp_singleton_unwrap": true, + "tengu_idle_amber_finch": false, + "tengu_vellum_siding": false, + "tengu_tangerine_ladder_boost": true, + "tengu_gleaming_fair": true, + "tengu_sage_compass2": { + "enabled": true + }, + "tengu_kairos_cron_durable": false, + "tengu_team_discovery": false, + "tengu_vscode_review_upsell": false, + "tengu_bridge_repl_v2": true, + "tengu_workout2": true, + "tengu_slate_nexus": true, + "tengu_keybinding_customization_release": true, + "tengu_blue_coaster": false, + "tengu_good_survey_transcript_ask_config": { + "probability": 0.5 + }, + "tengu_malort_pedway": { + "enabled": true, + "pixelValidation": false, + "clipboardPasteMultiline": true, + "screenshotFilter": true, + "mouseAnimation": true, + "hideBeforeAction": true, + "autoTargetDisplay": false, + "coordinateMode": "pixels" + }, + "tengu_quartz_heron": false, + "tengu_auto_mode_config": { + "enabled": "enabled", + "twoStageClassifier": true + }, + "tengu_copper_wren": false, + "tengu_permission_friction": true, + "tengu_marble_whisper": true, + "tengu_pewter_lantern": false, + "tengu_coral_beacon": true, + "tengu_classifier_disabled_surfaces": "", + "tengu_slate_kestrel": true, + "tengu_harbor_prism": false, + "tengu_slim_subagent_claudemd": true, + "tengu_log_datadog_events": true, + "tengu_tide_elm": "off", + "tengu_quiet_slate_wren": false, + "tengu_feedback_survey_config": { + "minTimeBeforeFeedbackMs": 600000, + "minTimeBetweenFeedbackMs": 43200000, + "minTimeBetweenGlobalFeedbackMs": 43200000, + "minUserTurnsBeforeFeedback": 5, + "minUserTurnsBetweenFeedback": 25, + "hideThanksAfterMs": 3000, + "onForModels": [ + "*" + ], + "probability": 0.05 + }, + "tengu_cobalt_lantern": true, + "tengu_worktree_mode": true, + "tengu_hawthorn_window": 200000, + "tengu_herring_clock": false, + "tengu-off-switch": { + "activated": false + }, + "tengu_velvet_moth": 0.2, + "tengu_grey_step2": { + "enabled": true, + "dialogTitle": "We recommend medium effort for Opus", + "dialogDescription": "Effort determines how long Claude thinks for when completing your task. We recommend medium effort for most tasks to balance speed and intelligence and maximize rate limits. Use ultrathink to trigger high effort when needed." + }, + "tengu_chomp_inflection": true, + "tengu_garnet_finch": false, + "tengu_brick_follow": false, + "tengu_startup_notice": "", + "tengu_chair_sermon": false, + "tengu_pewter_lark": "off", + "tengu_amber_lattice": { + "plugins": [ + "security-guidance", + "code-review", + "commit-commands", + "code-simplifier", + "hookify", + "feature-dev", + "frontend-design", + "pr-review-toolkit", + "skill-creator", + "plugin-dev", + "agent-sdk-dev", + "mcp-server-dev", + "claude-code-setup", + "claude-md-management", + "playground", + "ralph-loop", + "explanatory-output-style", + "learning-output-style", + "clangd-lsp", + "csharp-lsp", + "gopls-lsp", + "jdtls-lsp", + "kotlin-lsp", + "lua-lsp", + "php-lsp", + "pyright-lsp", + "ruby-lsp", + "rust-analyzer-lsp", + "swift-lsp", + "typescript-lsp" + ] + }, + "tengu_dunwich_bell": false, + "tengu_ashen_kelp": true, + "tengu_harbor_permissions": true, + "tengu_slate_moth": false, + "tengu_sepia_moth": false, + "tengu_cobalt_heron": false, + "tengu_silk_hinge": false, + "tengu_porch_bell_9f": "", + "tengu_plum_vx3": true, + "tengu_dune_wren": false, + "tengu_lapis_thicket": false, + "tengu_prompt_suggestion": true, + "tengu_ccr_bundle_seed_enabled": true, + "tengu_slate_ribbon": true, + "tengu_orchid_mantis": false, + "tengu_sotto_voce": true, + "tengu_satin_quoll": {}, + "tengu_noreread_q7m_velvet": false, + "tengu_quartz_vireo": "", + "tengu_osprey_lantern": false, + "tengu_amber_lynx": false, + "tengu_destructive_command_warning": false, + "tengu_prompt_cache_1h_config": { + "allowlist": [ + "repl_main_thread*", + "sdk", + "auto_mode", + "rolling_compact", + "memdir_relevance", + "agent_classifier", + "prompt_suggestion", + "away_summary", + "extract_memories" + ] + }, + "tengu_harbor_ledger": [ + { + "marketplace": "claude-plugins-official", + "plugin": "discord" + }, + { + "marketplace": "claude-plugins-official", + "plugin": "telegram" + }, + { + "marketplace": "claude-plugins-official", + "plugin": "fakechat" + }, + { + "marketplace": "claude-plugins-official", + "plugin": "imessage" + } + ], + "tengu_maple_tide": false, + "tengu_miraculo_the_bard": false, + "tengu_red_coaster": false, + "tengu_amber_wren": { + "targetedRangeNudge": true, + "maxTokens": 25000 + }, + "tengu_flint_harbor_prompt": { + "prompt": "You are helping a power user generate an onboarding guide for teammates who are new to Claude Code. The guide will live in the team's onboarding docs and can be pasted into Claude for an interactive walkthrough.\n\nYou're co-authoring this with them — collaborative and helpful, like a teammate who's done this before and is happy to share.\n\n## Usage data (last {{WINDOW_DAYS}} days)\n\nThis was scanned from the guide creator's local Claude Code transcripts:\n\n```json\n{{USAGE_DATA}}\n```\n\n## Your task\n\nBefore anything else — including before thinking through the classification — output exactly this line as your first visible text:\n\n> Looking at how you've used Claude over the last {{WINDOW_DAYS}} days to put together an onboarding guide for teammates new to Claude Code.\n\nThis must come before any extended thinking about session descriptors. The guide creator is staring at a blank screen until you do. Classification is step 2, not step 1.\n\nGenerate the guide immediately, then ask for revisions. Don't wait for answers first — it's easier for the guide creator to edit a concrete draft than answer abstract questions.\n\n1. **Output the acknowledgment line above.** No thinking, no classification, no tool calls before this. One line, then move on.\n\n2. **Derive the work-type breakdown.** Read the `sessionDescriptors` array — each entry describes one session via its title, any linked code reviews (`prNumbers`), and first user message. Classify each session into one of these task types:\n\n - **build_feature** — new functionality, scripts, tools, config/CI/env setup\n - **debug_fix** — investigating and fixing bugs\n - **improve_quality** — refactoring, tests, cleanup, code review\n - **analyze_data** — queries, metrics, number crunching\n - **plan_design** — architecture, approach, strategy, understanding unfamiliar code, design review\n - **prototype** — spikes, POCs, throwaway exploration\n - **write_docs** — PRDs, RFCs, READMEs, design docs, copy/doc review\n\n Categories describe the *type of task*, not the project or domain — a teammate on any project should recognize them. Review sessions belong with whatever's being reviewed: code review is improve_quality, doc review is write_docs, design review is plan_design. Most sessions fit the list; only invent a new category if it's genuinely a different type of task. Pick the top 3-5 with rough percentages. First messages alone are usually enough; titles and code-review links are enrichment. If first messages are uninformative, use tool and MCP counts as a weak hint. If there are ~0 sessions, leave the breakdown as a TODO.\n\n In the rendered guide, display categories with spaces and title case (e.g. \"Build Feature\" not \"build_feature\").\n\n3. **Gather the remaining pieces.** For repos, start with `currentRepo` and check the workspace for sibling repo directories. For MCP server setup, use each entry's `name` (and `urlOrigin` where present) to infer what the server does and how a teammate would get access. Leave the Team Tips and Get Started sections as TODO placeholders — you'll ask for these in Review and fill them in after.\n\n4. **Write the guide to `ONBOARDING.md`** following this template:\n\n```\n{{GUIDE_TEMPLATE}}\n```\n\n Fill in real numbers from the usage data (not placeholders). Use `generatedBy` for the name; if it's missing, omit the name. Ascii bar charts: `█` for filled, `░` for empty, 20 chars wide. Keep the HTML comment instruction at the bottom exactly as shown.\n\n5. **Render the guide in a code block, then close out the first turn.** You're co-authoring this guide with the guide creator — frame the follow-up as collaboration, not corrections.\n\n After the code block, add a `---` horizontal rule and a `**Review**` heading so the guide is visually separated from your questions. Under the heading, number these three questions:\n\n 1. \"I went with '[X]' for the team name — let me know if that sounds right.\" (or if you couldn't tell: \"What's the team name? I'll add it in.\")\n 2. Is there a starter task for someone new to Claude Code? (ticket or doc link — optional)\n 3. Any team tips you'd tell a new teammate that aren't already in CLAUDE.md?\n\n After they answer, update `ONBOARDING.md` with their team name, tips, and starter task. Then close with this exact line (not numbered, not paraphrased):\n\n Saved to `ONBOARDING.md`. Drop it in your team docs and channels — when a new teammate pastes it into Claude Code, they get a guided onboarding tour from there.\n\n Apply any edits they come back with to the file.", + "guideTemplate": "# Welcome to [Team Name]\n\n## How We Use Claude\n\nBased on [name]'s usage over the last [N] days:\n\nWork Type Breakdown:\n [Category 1] [ascii bar] [N]%\n [Category 2] [ascii bar] [N]%\n [Category 3] [ascii bar] [N]%\n ...\n\nTop Skills & Commands:\n [/command] [ascii bar] [N]x/month\n ...\n\nTop MCP Servers:\n [Server] [ascii bar] [N] calls\n ...\n\n## Your Setup Checklist\n\n### Codebases\n- [ ] [repo-name] — [repo url]\n...\n\n### MCP Servers to Activate\n- [ ] [Server] — [what it's for]. [How to get access]\n...\n\n### Skills to Know About\n- [/command] — [what it does, when the team uses it]\n...\n\n## Team Tips\n\n_TODO_\n\n## Get Started\n\n_TODO_\n\n", + "windowDays": 30 + }, + "tengu_quill_harbor": "acceptEdits", + "tengu_tab_read_sep": false, + "tengu_velvet_static": true, + "tengu_feature_claudified_template": false, + "tengu_basalt_tern": false, + "tengu_lantern_hearth": "off", + "tengu_windows_credman": false, + "tengu_loud_sugary_rock2": false + }, + "firstStartTime": "2026-05-06T03:06:04.304Z", + "opusProMigrationComplete": true, + "sonnet1m45MigrationComplete": true, + "seenNotifications": {}, + "migrationVersion": 13, + "userID": "7d61701f40d83c9cd513888f359544d66e9a0a81a3e8082fd68bdf0897b8eb19", + "changelogLastFetched": 1778036764386, + "claudeCodeFirstTokenDate": "2026-03-16T02:47:40.558902Z", + "hasCompletedOnboarding": true, + "lastOnboardingVersion": "2.1.129", + "cachedExperimentFeatures": [ + "tengu_amber_prism", + "tengu_cedar_inlet", + "tengu_coral_beacon", + "tengu_flint_harbor", + "tengu_mcp_subagent_prompt", + "tengu_orchid_mantis_v2", + "tengu_plank_river_frost", + "tengu_read_dedup_killswitch" + ], + "groveConfigCache": { + "a468bb23-ef26-430c-ba99-33fcb13b224c": { + "grove_enabled": true, + "timestamp": 1779508540743 + } + }, + "lastReleaseNotesSeen": "2.1.129", + "projects": { + "/home/node": { + "allowedTools": [], + "mcpContextUris": [], + "mcpServers": {}, + "enabledMcpjsonServers": [], + "disabledMcpjsonServers": [], + "hasTrustDialogAccepted": false, + "projectOnboardingSeenCount": 1, + "hasClaudeMdExternalIncludesApproved": false, + "hasClaudeMdExternalIncludesWarningShown": false, + "exampleFiles": [], + "lastGracefulShutdown": false, + "lastCost": 5.953176999999999, + "lastAPIDuration": 865155, + "lastAPIDurationWithoutRetries": 865092, + "lastToolDuration": 228516, + "lastDuration": 4047180, + "lastLinesAdded": 80, + "lastLinesRemoved": 7, + "lastTotalInputTokens": 617, + "lastTotalOutputTokens": 53129, + "lastTotalCacheCreationInputTokens": 143140, + "lastTotalCacheReadInputTokens": 7454484, + "lastTotalWebSearchRequests": 0, + "lastModelUsage": { + "claude-opus-4-7[1m]": { + "inputTokens": 617, + "outputTokens": 53129, + "cacheReadInputTokens": 7454484, + "cacheCreationInputTokens": 143140, + "webSearchRequests": 0, + "costUSD": 5.953176999999999 + } + }, + "lastSessionId": "544a289a-0493-4194-9fbd-112ed250e221", + "lastSessionMetrics": { + "frame_duration_ms_count": 18005, + "frame_duration_ms_min": 0.08510699999169447, + "frame_duration_ms_max": 11.760095999983605, + "frame_duration_ms_avg": 1.2271341631206178, + "frame_duration_ms_p50": 1.2588830000022426, + "frame_duration_ms_p95": 2.0925473999639506, + "frame_duration_ms_p99": 2.4603932999935925, + "pre_tool_hook_duration_ms_count": 63, + "pre_tool_hook_duration_ms_min": 0, + "pre_tool_hook_duration_ms_max": 1, + "pre_tool_hook_duration_ms_avg": 0.20634920634920634, + "pre_tool_hook_duration_ms_p50": 0, + "pre_tool_hook_duration_ms_p95": 1, + "pre_tool_hook_duration_ms_p99": 1, + "hook_duration_ms_count": 8, + "hook_duration_ms_min": 0, + "hook_duration_ms_max": 0, + "hook_duration_ms_avg": 0, + "hook_duration_ms_p50": 0, + "hook_duration_ms_p95": 0, + "hook_duration_ms_p99": 0 + }, + "lastHintSessionId": "9c4a7d92-e8cb-47c0-b341-d725695106ab", + "lastSessionFirstPrompt": "The editor on the MAM does not seem to be functioning, lets diagnose and fix it https://forge.wilddragon.net/zgaetano/wild-dragon", + "lastSessionModified": 1779201199377, + "lastFpsAverage": 4.57, + "lastFpsLow1Pct": 352.21 + } + }, + "penguinModeOrgEnabled": false, + "closedIssuesLastChecked": 1779574561797, + "clientDataCache": null, + "additionalModelOptionsCache": [], + "additionalModelCostsCache": {}, + "overageCreditGrantCache": { + "8d49cc62-f614-43b2-9d9a-7f8936e79653": { + "info": { + "available": false, + "eligible": false, + "granted": false, + "amount_minor_units": null, + "currency": null + }, + "timestamp": 1779574561941 + } + }, + "officialMarketplaceAutoInstallAttempted": true, + "officialMarketplaceAutoInstalled": true, + "claudeAiMcpEverConnected": [ + "claude.ai mcp-server", + "claude.ai Context7", + "claude.ai Gmail", + "claude.ai Google Drive", + "claude.ai Google Calendar", + "claude.ai ms365" + ], + "passesEligibilityCache": { + "8d49cc62-f614-43b2-9d9a-7f8936e79653": { + "eligible": true, + "referral_code_details": { + "code": "AOaXn7YPpQ", + "campaign": "claude_code_guest_pass_a47c", + "referral_link": "https://claude.ai/referral/AOaXn7YPpQ" + }, + "referrer_reward": { + "amount_minor_units": 1000, + "currency": "USD" + }, + "remaining_passes": 3, + "timestamp": 1779508535736 + } + }, + "cachedExtraUsageDisabledReason": "org_level_disabled", + "remoteControlUpsellSeenCount": 3, + "passesUpsellSeenCount": 0, + "hasVisitedPasses": false, + "passesLastSeenRemaining": 3, + "showSpinnerTree": false, + "skillUsage": { + "fewer-permission-prompts": { + "usageCount": 2, + "lastUsedAt": 1779539348728 + } + }, + "mcpServers": { + "wilddragon": { + "type": "http", + "url": "https://mcp.wilddragon.net/mcp", + "headers": { + "Authorization": "Bearer 4oi4NSxq4KYj49ZgA57f8CZi4la3NP8HGCm9cwsWZoc=" + } + } + }, + "oauthAccount": { + "accountUuid": "a468bb23-ef26-430c-ba99-33fcb13b224c", + "emailAddress": "zgaetano@wilddragon.net", + "organizationUuid": "8d49cc62-f614-43b2-9d9a-7f8936e79653", + "hasExtraUsageEnabled": false, + "billingType": "stripe_subscription", + "accountCreatedAt": "2026-01-10T14:54:28.096025Z", + "subscriptionCreatedAt": "2026-03-16T02:46:05.026170Z", + "ccOnboardingFlags": {}, + "claudeCodeTrialEndsAt": null, + "claudeCodeTrialDurationDays": null, + "seatTier": null, + "displayName": "Zac", + "organizationRole": "admin", + "workspaceRole": null, + "organizationName": "zgaetano@wilddragon.net's Organization" + } +} diff --git a/claude-data/backups/.claude.json.backup.1779771114331 b/claude-data/backups/.claude.json.backup.1779771114331 new file mode 100644 index 0000000..dab2b09 --- /dev/null +++ b/claude-data/backups/.claude.json.backup.1779771114331 @@ -0,0 +1,623 @@ +{ + "numStartups": 23, + "tipsHistory": { + "new-user-warmup": 1, + "plan-mode-for-complex-tasks": 2, + "color-when-multi-clauding": 3, + "terminal-setup": 7, + "memory-command": 7, + "theme-command": 10, + "status-line": 15, + "prompt-queue": 16, + "enter-to-steer-in-relatime": 16, + "todo-list": 17, + "install-github-app": 18, + "install-slack-app": 22, + "permissions": 22, + "drag-and-drop-images": 23 + }, + "promptQueueUseCount": 4, + "btwUseCount": 1, + "cachedGrowthBookFeatures": { + "tengu_ccr_post_turn_summary": false, + "tengu_ochre_hollow": false, + "tengu_ultraplan_config": { + "enabled": true + }, + "tengu_cinder_plover": "", + "tengu_fg_left_arrow_agents": false, + "claude_code_skills_dashboard_enabled_cli": false, + "tengu_amber_redwood2": "", + "tengu_timber_lark": "copy_a", + "tengu_disable_bypass_permissions_mode": false, + "tengu_kairos_input_needed_push": true, + "tengu_snippet_save": false, + "tengu_auto_mode_default_on": false, + "tengu_basalt_spur": false, + "tengu_copper_fox": false, + "tengu_olive_hinge": "", + "tengu_orchid_trellis": false, + "tengu_gypsum_kite": false, + "tengu_bg_attach_stall_ms": 5000, + "tengu_sessions_elevated_auth_enforcement": false, + "tengu_kestrel_arch": "OFF", + "tengu_velvet_ibis": {}, + "tengu_velvet_cascade": {}, + "tengu_classifier_summary_heuristic_emit": false, + "tengu_ember_latch": true, + "tengu_cedar_inlet": "off", + "tengu_loud_sugary_rock": false, + "tengu_quiet_basalt_echo": false, + "tengu_marble_sandcastle": false, + "tengu_willow_sentinel_ttl_hours": 1, + "tengu_pewter_summit": true, + "tengu_bramble_lintel": 7, + "tengu_max_version_config": {}, + "tengu_copper_bridge": true, + "tengu_amber_prism": true, + "tengu_flint_harbor": false, + "tengu_canary": {}, + "tengu_mcp_elicitation": true, + "tengu_trace_lantern": false, + "tengu_turtle_carbon": true, + "tengu_amber_sentinel": true, + "tengu_cobalt_ridge": true, + "tengu_fennel_kite_model": "", + "tengu_shining_fractals": false, + "tengu_bridge_attestation_enforce": false, + "tengu_sm_config": { + "minimumMessageTokensToInit": 150000, + "minimumTokensBetweenUpdate": 40000, + "toolCallsBetweenUpdates": 10 + }, + "tengu_immediate_model_command": false, + "tengu_doorbell_agave": false, + "tengu_nimble_amber_prose": false, + "tengu-top-of-feed-tip": { + "tip": "", + "color": "" + }, + "tengu_slate_harrier": "off", + "tengu_version_config": { + "minVersion": "1.0.24" + }, + "tengu_tussock_oriole": false, + "tengu_ccr_bridge_multi_session": true, + "tengu_sub_nomdrep_q7k": true, + "tengu_hazel_osprey_floor": 75000, + "tengu_hazel_osprey": false, + "tengu_amber_lark": false, + "tengu_slate_siskin": { + "enabled": false, + "timeoutMs": 8000, + "throttleMs": 30000, + "summaryLineThreshold": 5 + }, + "tengu_marble_lark": false, + "tengu_claudeai_mcp_connectors": true, + "tengu_kairos_loop_prompt": true, + "tengu_agent_list_attach": false, + "tengu_kairos_push_notifications": true, + "tengu_jade_anvil_4": false, + "tengu_mcp_retry_failed_remote": false, + "tengu_review_bughunter_config": { + "fleet_size": 5, + "max_duration_minutes": 10, + "agent_timeout_seconds": 600, + "total_wallclock_minutes": 22, + "model": "claude-opus-4-7", + "cost_note": "$5-$25", + "duration_note": "~5-10 min", + "enabled": true + }, + "tengu_compact_cache_prefix": true, + "tengu_passport_quail": false, + "tengu_onyx_plover": { + "enabled": false, + "minHours": 24, + "minSessions": 3, + "remoteEnabled": false + }, + "tengu_amber_rokovoko": 0.2, + "tengu_quiet_harbor": false, + "tengu_penguin_mode_promo": { + "discountPercent": 0, + "endDate": "Feb 16" + }, + "tengu_coral_fern": false, + "tengu_shale_finch": true, + "tengu_vellum_lantern": false, + "tengu_session_memory": false, + "tengu_vscode_onboarding": false, + "tengu_ccr_bundle_max_bytes": 104857600, + "tengu_bridge_requires_action_details": true, + "tengu_desktop_upsell_v2": { + "enabled": false + }, + "tengu_c4w_usage_limit_notifications_enabled": true, + "tengu_desktop_upsell": { + "enable_shortcut_tip": true, + "enable_startup_dialog": false + }, + "tengu_slate_finch": false, + "tengu_birch_compass": true, + "tengu_file_write_optimization": true, + "tengu_steady_lantern": false, + "tengu_anchor_tide": false, + "tengu_chert_bezel": true, + "tengu_sparrow_ledger": false, + "tengu_gouda_loop": true, + "tengu_auto_notice_once": true, + "tengu_crimson_echo": {}, + "tengu_skills_dashboard_enabled": false, + "tengu_classifier_summary_llm_emit": false, + "tengu_tool_pear": false, + "tengu_slate_meadow": true, + "tengu_orchid_mantis_v2": true, + "tengu_flint_harbor_share": true, + "tengu_ccr_v2_send_events_cli": false, + "tengu_code_diff_cli": true, + "tengu_pewter_brook": false, + "tengu_marble_whisper2": true, + "tengu_slate_harbor_experiment": false, + "tengu_amber_heron": false, + "tengu_prompt_cache_diagnostics": true, + "tengu_cobalt_wren": false, + "tengu_willow_refresh_ttl_hours": 0, + "tengu_sedge_lantern": true, + "tengu_gha_plugin_code_review": false, + "tengu_mcp_subagent_prompt": true, + "tengu_plank_river_frost": "user_intent", + "tengu_fennel_kite": false, + "tengu_lichen_compass": false, + "tengu_scratch": false, + "tengu_slate_thimble": false, + "tengu_scarf_coffee": false, + "tengu_collage_kaleidoscope": true, + "tengu_feature_template": false, + "tengu_drift_lantern": false, + "tengu_cedar_halo": false, + "tengu_amber_flint": true, + "tengu_lapis_finch": true, + "tengu_cinder_almanac": true, + "tengu_event_sampling_config": {}, + "tengu_surreal_dali": true, + "tengu_walrus_canteen": false, + "tengu_streaming_tool_execution2": true, + "tengu_system_prompt_global_cache": true, + "tengu_mocha_barista": true, + "tengu_slate_wren": false, + "tengu_hawthorn_steeple": false, + "tengu_moth_copse": false, + "tengu_frond_boric": {}, + "tengu_amber_anchor": false, + "tengu_swann_brevity": "focused", + "tengu_workflows_enabled": false, + "tengu_harbor": true, + "tengu_umber_petrel": false, + "tengu_bridge_repl_v2_config": { + "init_retry_max_attempts": 3, + "init_retry_base_delay_ms": 500, + "init_retry_jitter_fraction": 0.25, + "init_retry_max_delay_ms": 4000, + "http_timeout_ms": 10000, + "uuid_dedup_buffer_size": 2000, + "heartbeat_interval_ms": 20000, + "heartbeat_jitter_fraction": 0.1, + "token_refresh_buffer_ms": 600000, + "teardown_archive_timeout_ms": 1500, + "connect_timeout_ms": 15000, + "min_version": "2.1.70", + "should_show_app_upgrade_message": false + }, + "tengu_cork_lantern": false, + "tengu_bridge_poll_interval_ms": 0, + "tengu_penguins_enabled": true, + "tengu_tern_alloy": "copy_a", + "tengu_sage_compass": {}, + "tengu_crystal_beam": { + "budgetTokens": 0 + }, + "tengu_willow_mode": "hint_v2", + "tengu_ultraplan_timeout_seconds": 5400, + "tengu_otk_slot_v1": false, + "tengu_ultraplan_prompt_identifier": "visual_plan", + "tengu_billiard_aviary": false, + "tengu_cobalt_compass": true, + "tengu_cobalt_raccoon": true, + "tengu_ccr_bridge": true, + "tengu_marble_anvil": true, + "tengu_pewter_ledger": "OFF", + "tengu_sepia_cormorant": [], + "tengu_kairos_cron": true, + "tengu_fgts": true, + "tengu_ember_trail": "0", + "tengu_orford_ness": false, + "tengu_cork_m4q": true, + "tengu_pewter_kestrel": { + "global": 50000, + "Bash": 30000, + "PowerShell": 30000, + "Grep": 20000, + "Snip": 1000, + "StrReplaceBasedEditTool": 30000, + "BashSearchTool": 20000 + }, + "tengu_read_dedup_killswitch": false, + "tengu_tool_search_unsupported_models": [ + "haiku" + ], + "tengu_kairos_loop_dynamic": true, + "tengu_birthday_hat": false, + "tengu_plugin_official_mkt_git_fallback": true, + "tengu_post_compact_survey": false, + "tengu_ladder_mq7": false, + "tengu_react_vulnerability_warning": false, + "tengu_negative_interaction_transcript_ask_config": { + "probability": 0 + }, + "tengu_crimson_vector": false, + "tengu_bad_survey_transcript_ask_config": { + "probability": 1 + }, + "tengu_sedge_lantern_holdback": false, + "tengu_bridge_poll_interval_config": { + "poll_interval_ms_not_at_capacity": 2000, + "poll_interval_ms_at_capacity": 600000, + "heartbeat_interval_ms": 0, + "multisession_poll_interval_ms_not_at_capacity": 5000, + "multisession_poll_interval_ms_at_capacity": 60000, + "multisession_poll_interval_ms_partial_capacity": 5000, + "non_exclusive_heartbeat_interval_ms": 180000, + "session_keepalive_interval_ms": 0, + "session_keepalive_interval_v2_ms": 0 + }, + "tengu_loggia_carousel": false, + "tengu_1p_event_batch_config": { + "scheduledDelayMillis": 10000, + "maxExportBatchSize": 400, + "maxQueueSize": 8192, + "path": "/api/event_logging/v2/batch" + }, + "tengu_willow_census_ttl_hours": 24, + "tengu_bridge_min_version": { + "minVersion": "2.1.70" + }, + "tengu_prism_ledger": false, + "tengu_mcp_singleton_unwrap": true, + "tengu_idle_amber_finch": false, + "tengu_vellum_siding": false, + "tengu_tangerine_ladder_boost": true, + "tengu_gleaming_fair": true, + "tengu_sage_compass2": { + "enabled": true + }, + "tengu_kairos_cron_durable": false, + "tengu_team_discovery": false, + "tengu_vscode_review_upsell": false, + "tengu_bridge_repl_v2": true, + "tengu_workout2": true, + "tengu_slate_nexus": true, + "tengu_keybinding_customization_release": true, + "tengu_blue_coaster": false, + "tengu_good_survey_transcript_ask_config": { + "probability": 0.5 + }, + "tengu_malort_pedway": { + "enabled": true, + "pixelValidation": false, + "clipboardPasteMultiline": true, + "screenshotFilter": true, + "mouseAnimation": true, + "hideBeforeAction": true, + "autoTargetDisplay": false, + "coordinateMode": "pixels" + }, + "tengu_quartz_heron": false, + "tengu_auto_mode_config": { + "enabled": "enabled", + "twoStageClassifier": true + }, + "tengu_copper_wren": false, + "tengu_permission_friction": true, + "tengu_marble_whisper": true, + "tengu_pewter_lantern": false, + "tengu_coral_beacon": true, + "tengu_classifier_disabled_surfaces": "", + "tengu_slate_kestrel": true, + "tengu_harbor_prism": false, + "tengu_slim_subagent_claudemd": true, + "tengu_log_datadog_events": true, + "tengu_tide_elm": "off", + "tengu_quiet_slate_wren": false, + "tengu_feedback_survey_config": { + "minTimeBeforeFeedbackMs": 600000, + "minTimeBetweenFeedbackMs": 43200000, + "minTimeBetweenGlobalFeedbackMs": 43200000, + "minUserTurnsBeforeFeedback": 5, + "minUserTurnsBetweenFeedback": 25, + "hideThanksAfterMs": 3000, + "onForModels": [ + "*" + ], + "probability": 0.05 + }, + "tengu_cobalt_lantern": true, + "tengu_worktree_mode": true, + "tengu_hawthorn_window": 200000, + "tengu_herring_clock": false, + "tengu-off-switch": { + "activated": false + }, + "tengu_velvet_moth": 0.2, + "tengu_grey_step2": { + "enabled": true, + "dialogTitle": "We recommend medium effort for Opus", + "dialogDescription": "Effort determines how long Claude thinks for when completing your task. We recommend medium effort for most tasks to balance speed and intelligence and maximize rate limits. Use ultrathink to trigger high effort when needed." + }, + "tengu_chomp_inflection": true, + "tengu_garnet_finch": false, + "tengu_brick_follow": false, + "tengu_startup_notice": "", + "tengu_chair_sermon": false, + "tengu_pewter_lark": "off", + "tengu_amber_lattice": { + "plugins": [ + "security-guidance", + "code-review", + "commit-commands", + "code-simplifier", + "hookify", + "feature-dev", + "frontend-design", + "pr-review-toolkit", + "skill-creator", + "plugin-dev", + "agent-sdk-dev", + "mcp-server-dev", + "claude-code-setup", + "claude-md-management", + "playground", + "ralph-loop", + "explanatory-output-style", + "learning-output-style", + "clangd-lsp", + "csharp-lsp", + "gopls-lsp", + "jdtls-lsp", + "kotlin-lsp", + "lua-lsp", + "php-lsp", + "pyright-lsp", + "ruby-lsp", + "rust-analyzer-lsp", + "swift-lsp", + "typescript-lsp" + ] + }, + "tengu_dunwich_bell": false, + "tengu_ashen_kelp": true, + "tengu_harbor_permissions": true, + "tengu_slate_moth": false, + "tengu_sepia_moth": false, + "tengu_cobalt_heron": false, + "tengu_silk_hinge": false, + "tengu_porch_bell_9f": "", + "tengu_plum_vx3": true, + "tengu_dune_wren": false, + "tengu_lapis_thicket": false, + "tengu_prompt_suggestion": true, + "tengu_ccr_bundle_seed_enabled": true, + "tengu_slate_ribbon": true, + "tengu_orchid_mantis": false, + "tengu_sotto_voce": true, + "tengu_satin_quoll": {}, + "tengu_noreread_q7m_velvet": false, + "tengu_quartz_vireo": "", + "tengu_osprey_lantern": false, + "tengu_amber_lynx": false, + "tengu_destructive_command_warning": false, + "tengu_prompt_cache_1h_config": { + "allowlist": [ + "repl_main_thread*", + "sdk", + "auto_mode", + "rolling_compact", + "memdir_relevance", + "agent_classifier", + "prompt_suggestion", + "away_summary", + "extract_memories" + ] + }, + "tengu_harbor_ledger": [ + { + "marketplace": "claude-plugins-official", + "plugin": "discord" + }, + { + "marketplace": "claude-plugins-official", + "plugin": "telegram" + }, + { + "marketplace": "claude-plugins-official", + "plugin": "fakechat" + }, + { + "marketplace": "claude-plugins-official", + "plugin": "imessage" + } + ], + "tengu_maple_tide": false, + "tengu_miraculo_the_bard": false, + "tengu_red_coaster": false, + "tengu_amber_wren": { + "targetedRangeNudge": true, + "maxTokens": 25000 + }, + "tengu_flint_harbor_prompt": { + "prompt": "You are helping a power user generate an onboarding guide for teammates who are new to Claude Code. The guide will live in the team's onboarding docs and can be pasted into Claude for an interactive walkthrough.\n\nYou're co-authoring this with them — collaborative and helpful, like a teammate who's done this before and is happy to share.\n\n## Usage data (last {{WINDOW_DAYS}} days)\n\nThis was scanned from the guide creator's local Claude Code transcripts:\n\n```json\n{{USAGE_DATA}}\n```\n\n## Your task\n\nBefore anything else — including before thinking through the classification — output exactly this line as your first visible text:\n\n> Looking at how you've used Claude over the last {{WINDOW_DAYS}} days to put together an onboarding guide for teammates new to Claude Code.\n\nThis must come before any extended thinking about session descriptors. The guide creator is staring at a blank screen until you do. Classification is step 2, not step 1.\n\nGenerate the guide immediately, then ask for revisions. Don't wait for answers first — it's easier for the guide creator to edit a concrete draft than answer abstract questions.\n\n1. **Output the acknowledgment line above.** No thinking, no classification, no tool calls before this. One line, then move on.\n\n2. **Derive the work-type breakdown.** Read the `sessionDescriptors` array — each entry describes one session via its title, any linked code reviews (`prNumbers`), and first user message. Classify each session into one of these task types:\n\n - **build_feature** — new functionality, scripts, tools, config/CI/env setup\n - **debug_fix** — investigating and fixing bugs\n - **improve_quality** — refactoring, tests, cleanup, code review\n - **analyze_data** — queries, metrics, number crunching\n - **plan_design** — architecture, approach, strategy, understanding unfamiliar code, design review\n - **prototype** — spikes, POCs, throwaway exploration\n - **write_docs** — PRDs, RFCs, READMEs, design docs, copy/doc review\n\n Categories describe the *type of task*, not the project or domain — a teammate on any project should recognize them. Review sessions belong with whatever's being reviewed: code review is improve_quality, doc review is write_docs, design review is plan_design. Most sessions fit the list; only invent a new category if it's genuinely a different type of task. Pick the top 3-5 with rough percentages. First messages alone are usually enough; titles and code-review links are enrichment. If first messages are uninformative, use tool and MCP counts as a weak hint. If there are ~0 sessions, leave the breakdown as a TODO.\n\n In the rendered guide, display categories with spaces and title case (e.g. \"Build Feature\" not \"build_feature\").\n\n3. **Gather the remaining pieces.** For repos, start with `currentRepo` and check the workspace for sibling repo directories. For MCP server setup, use each entry's `name` (and `urlOrigin` where present) to infer what the server does and how a teammate would get access. Leave the Team Tips and Get Started sections as TODO placeholders — you'll ask for these in Review and fill them in after.\n\n4. **Write the guide to `ONBOARDING.md`** following this template:\n\n```\n{{GUIDE_TEMPLATE}}\n```\n\n Fill in real numbers from the usage data (not placeholders). Use `generatedBy` for the name; if it's missing, omit the name. Ascii bar charts: `█` for filled, `░` for empty, 20 chars wide. Keep the HTML comment instruction at the bottom exactly as shown.\n\n5. **Render the guide in a code block, then close out the first turn.** You're co-authoring this guide with the guide creator — frame the follow-up as collaboration, not corrections.\n\n After the code block, add a `---` horizontal rule and a `**Review**` heading so the guide is visually separated from your questions. Under the heading, number these three questions:\n\n 1. \"I went with '[X]' for the team name — let me know if that sounds right.\" (or if you couldn't tell: \"What's the team name? I'll add it in.\")\n 2. Is there a starter task for someone new to Claude Code? (ticket or doc link — optional)\n 3. Any team tips you'd tell a new teammate that aren't already in CLAUDE.md?\n\n After they answer, update `ONBOARDING.md` with their team name, tips, and starter task. Then close with this exact line (not numbered, not paraphrased):\n\n Saved to `ONBOARDING.md`. Drop it in your team docs and channels — when a new teammate pastes it into Claude Code, they get a guided onboarding tour from there.\n\n Apply any edits they come back with to the file.", + "guideTemplate": "# Welcome to [Team Name]\n\n## How We Use Claude\n\nBased on [name]'s usage over the last [N] days:\n\nWork Type Breakdown:\n [Category 1] [ascii bar] [N]%\n [Category 2] [ascii bar] [N]%\n [Category 3] [ascii bar] [N]%\n ...\n\nTop Skills & Commands:\n [/command] [ascii bar] [N]x/month\n ...\n\nTop MCP Servers:\n [Server] [ascii bar] [N] calls\n ...\n\n## Your Setup Checklist\n\n### Codebases\n- [ ] [repo-name] — [repo url]\n...\n\n### MCP Servers to Activate\n- [ ] [Server] — [what it's for]. [How to get access]\n...\n\n### Skills to Know About\n- [/command] — [what it does, when the team uses it]\n...\n\n## Team Tips\n\n_TODO_\n\n## Get Started\n\n_TODO_\n\n", + "windowDays": 30 + }, + "tengu_quill_harbor": "acceptEdits", + "tengu_tab_read_sep": false, + "tengu_velvet_static": true, + "tengu_feature_claudified_template": false, + "tengu_basalt_tern": false, + "tengu_lantern_hearth": "off", + "tengu_windows_credman": false, + "tengu_loud_sugary_rock2": false + }, + "firstStartTime": "2026-05-06T03:06:04.304Z", + "opusProMigrationComplete": true, + "sonnet1m45MigrationComplete": true, + "seenNotifications": {}, + "migrationVersion": 13, + "userID": "7d61701f40d83c9cd513888f359544d66e9a0a81a3e8082fd68bdf0897b8eb19", + "changelogLastFetched": 1778036764386, + "claudeCodeFirstTokenDate": "2026-03-16T02:47:40.558902Z", + "hasCompletedOnboarding": true, + "lastOnboardingVersion": "2.1.129", + "cachedExperimentFeatures": [ + "tengu_amber_prism", + "tengu_cedar_inlet", + "tengu_coral_beacon", + "tengu_flint_harbor", + "tengu_mcp_subagent_prompt", + "tengu_orchid_mantis_v2", + "tengu_plank_river_frost", + "tengu_read_dedup_killswitch" + ], + "groveConfigCache": { + "a468bb23-ef26-430c-ba99-33fcb13b224c": { + "grove_enabled": true, + "timestamp": 1779508540743 + } + }, + "lastReleaseNotesSeen": "2.1.129", + "projects": { + "/home/node": { + "allowedTools": [], + "mcpContextUris": [], + "mcpServers": {}, + "enabledMcpjsonServers": [], + "disabledMcpjsonServers": [], + "hasTrustDialogAccepted": false, + "projectOnboardingSeenCount": 1, + "hasClaudeMdExternalIncludesApproved": false, + "hasClaudeMdExternalIncludesWarningShown": false, + "exampleFiles": [], + "lastGracefulShutdown": true, + "lastCost": 0, + "lastAPIDuration": 0, + "lastAPIDurationWithoutRetries": 0, + "lastToolDuration": 0, + "lastDuration": 1802249, + "lastLinesAdded": 0, + "lastLinesRemoved": 0, + "lastTotalInputTokens": 0, + "lastTotalOutputTokens": 0, + "lastTotalCacheCreationInputTokens": 0, + "lastTotalCacheReadInputTokens": 0, + "lastTotalWebSearchRequests": 0, + "lastModelUsage": {}, + "lastSessionId": "a35d7fc6-46ab-4f82-ad00-cc013c22a422", + "lastSessionMetrics": { + "frame_duration_ms_count": 60, + "frame_duration_ms_min": 0.08933199999955832, + "frame_duration_ms_max": 4.8925859999999375, + "frame_duration_ms_avg": 0.6829539666659116, + "frame_duration_ms_p50": 0.370852499999728, + "frame_duration_ms_p95": 2.300691550000112, + "frame_duration_ms_p99": 4.704050319999977 + }, + "lastHintSessionId": "9c4a7d92-e8cb-47c0-b341-d725695106ab", + "lastSessionFirstPrompt": "The editor on the MAM does not seem to be functioning, lets diagnose and fix it https://forge.wilddragon.net/zgaetano/wild-dragon", + "lastSessionModified": 1779201199377, + "lastFpsAverage": 0.03, + "lastFpsLow1Pct": 204.39 + } + }, + "penguinModeOrgEnabled": false, + "closedIssuesLastChecked": 1779574561797, + "clientDataCache": null, + "additionalModelOptionsCache": [], + "additionalModelCostsCache": {}, + "overageCreditGrantCache": { + "8d49cc62-f614-43b2-9d9a-7f8936e79653": { + "info": { + "available": false, + "eligible": false, + "granted": false, + "amount_minor_units": null, + "currency": null + }, + "timestamp": 1779574561941 + } + }, + "officialMarketplaceAutoInstallAttempted": true, + "officialMarketplaceAutoInstalled": true, + "claudeAiMcpEverConnected": [ + "claude.ai mcp-server", + "claude.ai Context7", + "claude.ai Gmail", + "claude.ai Google Drive", + "claude.ai Google Calendar", + "claude.ai ms365" + ], + "passesEligibilityCache": { + "8d49cc62-f614-43b2-9d9a-7f8936e79653": { + "eligible": true, + "referral_code_details": { + "code": "AOaXn7YPpQ", + "campaign": "claude_code_guest_pass_a47c", + "referral_link": "https://claude.ai/referral/AOaXn7YPpQ" + }, + "referrer_reward": { + "amount_minor_units": 1000, + "currency": "USD" + }, + "remaining_passes": 3, + "timestamp": 1779508535736 + } + }, + "cachedExtraUsageDisabledReason": "org_level_disabled", + "remoteControlUpsellSeenCount": 3, + "passesUpsellSeenCount": 0, + "hasVisitedPasses": false, + "passesLastSeenRemaining": 3, + "showSpinnerTree": false, + "skillUsage": { + "fewer-permission-prompts": { + "usageCount": 2, + "lastUsedAt": 1779539348728 + } + }, + "mcpServers": { + "wilddragon": { + "type": "http", + "url": "https://mcp.wilddragon.net/mcp", + "headers": { + "Authorization": "Bearer 4oi4NSxq4KYj49ZgA57f8CZi4la3NP8HGCm9cwsWZoc=" + } + } + }, + "oauthAccount": { + "accountUuid": "a468bb23-ef26-430c-ba99-33fcb13b224c", + "emailAddress": "zgaetano@wilddragon.net", + "organizationUuid": "8d49cc62-f614-43b2-9d9a-7f8936e79653", + "hasExtraUsageEnabled": false, + "billingType": "stripe_subscription", + "accountCreatedAt": "2026-01-10T14:54:28.096025Z", + "subscriptionCreatedAt": "2026-03-16T02:46:05.026170Z", + "ccOnboardingFlags": {}, + "claudeCodeTrialEndsAt": null, + "claudeCodeTrialDurationDays": null, + "seatTier": null, + "displayName": "Zac", + "organizationRole": "admin", + "workspaceRole": null, + "organizationName": "zgaetano@wilddragon.net's Organization" + } +} \ No newline at end of file diff --git a/claude-data/backups/.claude.json.backup.1779830191537 b/claude-data/backups/.claude.json.backup.1779830191537 new file mode 100644 index 0000000..a9a9bc6 --- /dev/null +++ b/claude-data/backups/.claude.json.backup.1779830191537 @@ -0,0 +1,630 @@ +{ + "numStartups": 23, + "tipsHistory": { + "new-user-warmup": 1, + "plan-mode-for-complex-tasks": 2, + "color-when-multi-clauding": 3, + "terminal-setup": 7, + "memory-command": 7, + "theme-command": 10, + "status-line": 15, + "prompt-queue": 16, + "enter-to-steer-in-relatime": 16, + "todo-list": 17, + "install-github-app": 18, + "install-slack-app": 22, + "permissions": 22, + "drag-and-drop-images": 23 + }, + "promptQueueUseCount": 4, + "btwUseCount": 1, + "cachedGrowthBookFeatures": { + "tengu_immediate_model_command": false, + "tengu_sage_compass": {}, + "tengu_canary": {}, + "tengu_sedge_lantern": true, + "tengu_bridge_attestation_enforce": false, + "tengu_classifier_summary_heuristic_emit": false, + "tengu_bridge_repl_v2": true, + "tengu_plugin_official_mkt_git_fallback": true, + "tengu_workflows_enabled": false, + "tengu_willow_sentinel_ttl_hours": 1, + "tengu_porch_bell_9f": "", + "tengu_tide_elm": "off", + "tengu_bridge_repl_v2_config": { + "init_retry_max_attempts": 3, + "init_retry_base_delay_ms": 500, + "init_retry_jitter_fraction": 0.25, + "init_retry_max_delay_ms": 4000, + "http_timeout_ms": 10000, + "uuid_dedup_buffer_size": 2000, + "heartbeat_interval_ms": 20000, + "heartbeat_jitter_fraction": 0.1, + "token_refresh_buffer_ms": 600000, + "teardown_archive_timeout_ms": 1500, + "connect_timeout_ms": 15000, + "min_version": "2.1.70", + "should_show_app_upgrade_message": false + }, + "tengu_mcp_retry_failed_remote": false, + "tengu_tool_search_unsupported_models": [ + "haiku" + ], + "tengu_chair_sermon": false, + "tengu_orchid_mantis_v2": true, + "tengu_garnet_finch": false, + "tengu_destructive_command_warning": false, + "tengu_willow_census_ttl_hours": 24, + "tengu_mcp_singleton_unwrap": true, + "tengu_ccr_bridge": true, + "tengu_feedback_survey_config": { + "minTimeBeforeFeedbackMs": 600000, + "minTimeBetweenFeedbackMs": 43200000, + "minTimeBetweenGlobalFeedbackMs": 43200000, + "minUserTurnsBeforeFeedback": 5, + "minUserTurnsBetweenFeedback": 25, + "hideThanksAfterMs": 3000, + "onForModels": [ + "*" + ], + "probability": 0.05 + }, + "tengu_vscode_review_upsell": false, + "tengu_scarf_coffee": false, + "tengu_pewter_kestrel": { + "global": 50000, + "Bash": 30000, + "PowerShell": 30000, + "Grep": 20000, + "Snip": 1000, + "StrReplaceBasedEditTool": 30000, + "BashSearchTool": 20000 + }, + "tengu_timber_lark": "copy_a", + "tengu_collage_kaleidoscope": true, + "tengu_slate_harbor_experiment": false, + "tengu_orford_ness": false, + "tengu_amber_prism": true, + "tengu_drift_lantern": false, + "tengu_snippet_save": false, + "tengu_sm_config": { + "minimumMessageTokensToInit": 150000, + "minimumTokensBetweenUpdate": 40000, + "toolCallsBetweenUpdates": 10 + }, + "tengu_cork_lantern": false, + "tengu_malort_pedway": { + "enabled": true, + "pixelValidation": false, + "clipboardPasteMultiline": true, + "screenshotFilter": true, + "mouseAnimation": true, + "hideBeforeAction": true, + "autoTargetDisplay": false, + "coordinateMode": "pixels" + }, + "tengu_lichen_compass": false, + "tengu_harbor_permissions": true, + "tengu_anchor_tide": false, + "tengu_willow_refresh_ttl_hours": 0, + "tengu_slate_finch": false, + "tengu_kestrel_arch": "OFF", + "tengu_moss_anchor": false, + "tengu_penguins_enabled": true, + "tengu_flint_harbor": false, + "tengu_worktree_mode": true, + "tengu_auto_mode_default_on": false, + "tengu_ember_latch": true, + "tengu_plum_vx3": true, + "tengu_sotto_voce": true, + "tengu_kairos_push_notifications": true, + "tengu_slim_subagent_claudemd": true, + "tengu_noreread_q7m_velvet": false, + "tengu_negative_interaction_transcript_ask_config": { + "probability": 0 + }, + "tengu_auto_mode_config": { + "enabled": "enabled", + "twoStageClassifier": true + }, + "tengu_amber_lattice": { + "plugins": [ + "security-guidance", + "code-review", + "commit-commands", + "code-simplifier", + "hookify", + "feature-dev", + "frontend-design", + "pr-review-toolkit", + "skill-creator", + "plugin-dev", + "agent-sdk-dev", + "mcp-server-dev", + "claude-code-setup", + "claude-md-management", + "playground", + "ralph-loop", + "explanatory-output-style", + "learning-output-style", + "clangd-lsp", + "csharp-lsp", + "gopls-lsp", + "jdtls-lsp", + "kotlin-lsp", + "lua-lsp", + "php-lsp", + "pyright-lsp", + "ruby-lsp", + "rust-analyzer-lsp", + "swift-lsp", + "typescript-lsp" + ] + }, + "tengu_agent_list_attach": false, + "tengu_bridge_poll_interval_config": { + "poll_interval_ms_not_at_capacity": 2000, + "poll_interval_ms_at_capacity": 600000, + "heartbeat_interval_ms": 0, + "multisession_poll_interval_ms_not_at_capacity": 5000, + "multisession_poll_interval_ms_at_capacity": 60000, + "multisession_poll_interval_ms_partial_capacity": 5000, + "non_exclusive_heartbeat_interval_ms": 180000, + "session_keepalive_interval_ms": 0, + "session_keepalive_interval_v2_ms": 0 + }, + "tengu_vellum_siding": false, + "tengu_feature_template": false, + "tengu_marble_lark": false, + "tengu_vscode_onboarding": false, + "tengu_crimson_echo": {}, + "tengu_gha_plugin_code_review": false, + "tengu_walrus_canteen": false, + "tengu_copper_wren": false, + "tengu_velvet_cascade": {}, + "tengu_system_prompt_global_cache": true, + "tengu_idle_amber_finch": false, + "tengu_amber_sentinel": true, + "tengu_crystal_beam": { + "budgetTokens": 0 + }, + "claude_code_skills_dashboard_enabled_cli": false, + "tengu_cobalt_ridge": true, + "tengu_team_discovery": false, + "tengu_bridge_poll_interval_ms": 0, + "tengu_pewter_ledger": "OFF", + "tengu_read_dedup_killswitch": false, + "tengu_copper_fox": false, + "tengu_bad_survey_transcript_ask_config": { + "probability": 1 + }, + "tengu_miraculo_the_bard": false, + "tengu_gleaming_fair": true, + "tengu_hazel_osprey": false, + "tengu_tool_pear": false, + "tengu_pewter_lantern": false, + "tengu_penguin_mode_promo": { + "discountPercent": 0, + "endDate": "Feb 16" + }, + "tengu_tern_alloy": "copy_a", + "tengu_billiard_aviary": false, + "tengu_ashen_kelp": true, + "tengu_cobalt_heron": false, + "tengu_slate_moth": false, + "tengu_post_compact_survey": false, + "tengu_kairos_loop_prompt": true, + "tengu_fgts": true, + "tengu_otk_slot_v1": false, + "tengu_kairos_loop_dynamic": true, + "tengu_sessions_elevated_auth_enforcement": false, + "tengu_harbor_ledger": [ + { + "marketplace": "claude-plugins-official", + "plugin": "discord" + }, + { + "marketplace": "claude-plugins-official", + "plugin": "telegram" + }, + { + "marketplace": "claude-plugins-official", + "plugin": "fakechat" + }, + { + "marketplace": "claude-plugins-official", + "plugin": "imessage" + } + ], + "tengu_react_vulnerability_warning": false, + "tengu_plank_river_frost": "user_intent", + "tengu_kairos_cron": true, + "tengu_ccr_bundle_seed_enabled": true, + "tengu_turtle_carbon": true, + "tengu_cobalt_lantern": true, + "tengu_cedar_halo": false, + "tengu_event_sampling_config": {}, + "tengu_velvet_moth": 0.2, + "tengu_ccr_post_turn_summary": false, + "tengu_session_memory": false, + "tengu_slate_meadow": true, + "tengu_slate_wren": false, + "tengu_ladder_mq7": false, + "tengu_ccr_bridge_multi_session": true, + "tengu_steady_lantern": false, + "tengu_dunwich_bell": false, + "tengu_bramble_lintel": 7, + "tengu_1p_event_batch_config": { + "scheduledDelayMillis": 10000, + "maxExportBatchSize": 400, + "maxQueueSize": 8192, + "path": "/api/event_logging/v2/batch" + }, + "tengu_slate_thimble": false, + "tengu_review_bughunter_config": { + "fleet_size": 5, + "max_duration_minutes": 10, + "agent_timeout_seconds": 600, + "total_wallclock_minutes": 22, + "model": "claude-opus-4-7", + "cost_note": "$5-$25", + "duration_note": "~5-10 min", + "enabled": true + }, + "tengu_frond_boric": {}, + "tengu_nimble_amber_prose": false, + "tengu_slate_kestrel": true, + "tengu_keybinding_customization_release": true, + "tengu_disable_bypass_permissions_mode": false, + "tengu_sub_nomdrep_q7k": true, + "tengu_vellum_lantern": false, + "tengu_cinder_almanac": true, + "tengu_slate_siskin": { + "enabled": false, + "timeoutMs": 8000, + "throttleMs": 30000, + "summaryLineThreshold": 5 + }, + "tengu-off-switch": { + "activated": false + }, + "tengu_herring_clock": false, + "tengu_hawthorn_window": 200000, + "tengu_fennel_kite": false, + "tengu_good_survey_transcript_ask_config": { + "probability": 0.5 + }, + "tengu_compact_cache_prefix": true, + "tengu_umber_petrel": false, + "tengu_streaming_tool_execution2": true, + "tengu_fg_left_arrow_agents": false, + "tengu_classifier_summary_llm_emit": false, + "tengu_ultraplan_prompt_identifier": "visual_plan", + "tengu_slate_harrier": "off", + "tengu_velvet_ibis": {}, + "tengu_crimson_vector": false, + "tengu_amber_lark": false, + "tengu_ember_trail": "0", + "tengu_copper_bridge": true, + "tengu_birthday_hat": false, + "tengu_maple_tide": false, + "tengu_max_version_config": {}, + "tengu_orchid_trellis": false, + "tengu_jade_anvil_4": false, + "tengu_gypsum_kite": false, + "tengu_gouda_loop": true, + "tengu_prompt_cache_diagnostics": true, + "tengu_kairos_input_needed_push": true, + "tengu_cork_m4q": true, + "tengu_scratch": false, + "tengu_loud_sugary_rock": false, + "tengu_cobalt_wren": false, + "tengu_prompt_suggestion": true, + "tengu_bg_attach_stall_ms": 5000, + "tengu_loggia_carousel": false, + "tengu_skills_dashboard_enabled": false, + "tengu_amber_lynx": false, + "tengu_lapis_finch": true, + "tengu_mocha_barista": true, + "tengu_slate_nexus": true, + "tengu_mcp_subagent_prompt": true, + "tengu_chert_bezel": true, + "tengu_flint_harbor_prompt": { + "prompt": "You are helping a power user generate an onboarding guide for teammates who are new to Claude Code. The guide will live in the team's onboarding docs and can be pasted into Claude for an interactive walkthrough.\n\nYou're co-authoring this with them — collaborative and helpful, like a teammate who's done this before and is happy to share.\n\n## Usage data (last {{WINDOW_DAYS}} days)\n\nThis was scanned from the guide creator's local Claude Code transcripts:\n\n```json\n{{USAGE_DATA}}\n```\n\n## Your task\n\nBefore anything else — including before thinking through the classification — output exactly this line as your first visible text:\n\n> Looking at how you've used Claude over the last {{WINDOW_DAYS}} days to put together an onboarding guide for teammates new to Claude Code.\n\nThis must come before any extended thinking about session descriptors. The guide creator is staring at a blank screen until you do. Classification is step 2, not step 1.\n\nGenerate the guide immediately, then ask for revisions. Don't wait for answers first — it's easier for the guide creator to edit a concrete draft than answer abstract questions.\n\n1. **Output the acknowledgment line above.** No thinking, no classification, no tool calls before this. One line, then move on.\n\n2. **Derive the work-type breakdown.** Read the `sessionDescriptors` array — each entry describes one session via its title, any linked code reviews (`prNumbers`), and first user message. Classify each session into one of these task types:\n\n - **build_feature** — new functionality, scripts, tools, config/CI/env setup\n - **debug_fix** — investigating and fixing bugs\n - **improve_quality** — refactoring, tests, cleanup, code review\n - **analyze_data** — queries, metrics, number crunching\n - **plan_design** — architecture, approach, strategy, understanding unfamiliar code, design review\n - **prototype** — spikes, POCs, throwaway exploration\n - **write_docs** — PRDs, RFCs, READMEs, design docs, copy/doc review\n\n Categories describe the *type of task*, not the project or domain — a teammate on any project should recognize them. Review sessions belong with whatever's being reviewed: code review is improve_quality, doc review is write_docs, design review is plan_design. Most sessions fit the list; only invent a new category if it's genuinely a different type of task. Pick the top 3-5 with rough percentages. First messages alone are usually enough; titles and code-review links are enrichment. If first messages are uninformative, use tool and MCP counts as a weak hint. If there are ~0 sessions, leave the breakdown as a TODO.\n\n In the rendered guide, display categories with spaces and title case (e.g. \"Build Feature\" not \"build_feature\").\n\n3. **Gather the remaining pieces.** For repos, start with `currentRepo` and check the workspace for sibling repo directories. For MCP server setup, use each entry's `name` (and `urlOrigin` where present) to infer what the server does and how a teammate would get access. Leave the Team Tips and Get Started sections as TODO placeholders — you'll ask for these in Review and fill them in after.\n\n4. **Write the guide to `ONBOARDING.md`** following this template:\n\n```\n{{GUIDE_TEMPLATE}}\n```\n\n Fill in real numbers from the usage data (not placeholders). Use `generatedBy` for the name; if it's missing, omit the name. Ascii bar charts: `█` for filled, `░` for empty, 20 chars wide. Keep the HTML comment instruction at the bottom exactly as shown.\n\n5. **Render the guide in a code block, then close out the first turn.** You're co-authoring this guide with the guide creator — frame the follow-up as collaboration, not corrections.\n\n After the code block, add a `---` horizontal rule and a `**Review**` heading so the guide is visually separated from your questions. Under the heading, number these three questions:\n\n 1. \"I went with '[X]' for the team name — let me know if that sounds right.\" (or if you couldn't tell: \"What's the team name? I'll add it in.\")\n 2. Is there a starter task for someone new to Claude Code? (ticket or doc link — optional)\n 3. Any team tips you'd tell a new teammate that aren't already in CLAUDE.md?\n\n After they answer, update `ONBOARDING.md` with their team name, tips, and starter task. Then close with this exact line (not numbered, not paraphrased):\n\n Saved to `ONBOARDING.md`. Drop it in your team docs and channels — when a new teammate pastes it into Claude Code, they get a guided onboarding tour from there.\n\n Apply any edits they come back with to the file.", + "guideTemplate": "# Welcome to [Team Name]\n\n## How We Use Claude\n\nBased on [name]'s usage over the last [N] days:\n\nWork Type Breakdown:\n [Category 1] [ascii bar] [N]%\n [Category 2] [ascii bar] [N]%\n [Category 3] [ascii bar] [N]%\n ...\n\nTop Skills & Commands:\n [/command] [ascii bar] [N]x/month\n ...\n\nTop MCP Servers:\n [Server] [ascii bar] [N] calls\n ...\n\n## Your Setup Checklist\n\n### Codebases\n- [ ] [repo-name] — [repo url]\n...\n\n### MCP Servers to Activate\n- [ ] [Server] — [what it's for]. [How to get access]\n...\n\n### Skills to Know About\n- [/command] — [what it does, when the team uses it]\n...\n\n## Team Tips\n\n_TODO_\n\n## Get Started\n\n_TODO_\n\n", + "windowDays": 30 + }, + "tengu_quartz_vireo": "", + "tengu_ccr_v2_send_events_cli": false, + "tengu_harbor_willow": false, + "tengu_slate_ribbon": true, + "tengu_version_config": { + "minVersion": "1.0.24" + }, + "tengu_mcp_elicitation": true, + "tengu_kairos_cron_durable": false, + "tengu_pewter_lark": "off", + "tengu_ultraplan_config": { + "enabled": true + }, + "tengu_brick_follow": false, + "tengu_amber_heron": false, + "tengu_quiet_basalt_echo": false, + "tengu_quiet_harbor": false, + "tengu_maple_pier": false, + "tengu_coral_fern": false, + "tengu_tangerine_ladder_boost": true, + "tengu_workout2": true, + "tengu_ochre_hollow": false, + "tengu_tussock_oriole": false, + "tengu_claudeai_mcp_connectors": true, + "tengu_startup_notice": "", + "tengu_desktop_upsell": { + "enable_shortcut_tip": true, + "enable_startup_dialog": false + }, + "tengu_coral_beacon": true, + "tengu_lapis_thicket": false, + "tengu_code_diff_cli": true, + "tengu_harbor_prism": false, + "tengu_olive_hinge": "", + "tengu_osprey_lantern": false, + "tengu_onyx_plover": { + "enabled": false, + "minHours": 24, + "minSessions": 3, + "remoteEnabled": false + }, + "tengu_grey_step2": { + "enabled": true, + "dialogTitle": "We recommend medium effort for Opus", + "dialogDescription": "Effort determines how long Claude thinks for when completing your task. We recommend medium effort for most tasks to balance speed and intelligence and maximize rate limits. Use ultrathink to trigger high effort when needed." + }, + "tengu_moth_copse": false, + "tengu_blue_coaster": false, + "tengu_harbor": true, + "tengu_passport_quail": false, + "tengu_cobalt_compass": true, + "tengu-top-of-feed-tip": { + "tip": "", + "color": "" + }, + "tengu_amber_flint": true, + "tengu_permission_friction": true, + "tengu_amber_wren": { + "targetedRangeNudge": true, + "maxTokens": 25000 + }, + "tengu_quartz_heron": false, + "tengu_orchid_mantis": false, + "tengu_satin_quoll": {}, + "tengu_ccr_bundle_max_bytes": 104857600, + "tengu_marble_anvil": true, + "tengu_pewter_brook": false, + "tengu_hawthorn_steeple": false, + "tengu_prompt_cache_1h_config": { + "allowlist": [ + "repl_main_thread*", + "sdk", + "auto_mode", + "rolling_compact", + "memdir_relevance", + "agent_classifier", + "prompt_suggestion", + "away_summary", + "extract_memories" + ] + }, + "tengu_marble_whisper2": true, + "tengu_willow_mode": "hint_v2", + "tengu_fennel_kite_model": "", + "tengu_flint_harbor_share": true, + "tengu_red_coaster": false, + "tengu_chomp_inflection": true, + "tengu_cedar_inlet": "off", + "tengu_silk_hinge": false, + "tengu_sepia_cormorant": [], + "tengu_surreal_dali": true, + "tengu_sedge_lantern_holdback": false, + "tengu_shining_fractals": false, + "tengu_bridge_requires_action_details": true, + "tengu_shale_finch": true, + "tengu_amber_anchor": false, + "tengu_bridge_min_version": { + "minVersion": "2.1.70" + }, + "tengu_quiet_slate_wren": false, + "tengu_dune_wren": false, + "tengu_marble_whisper": true, + "tengu_auto_notice_once": true, + "tengu_cobalt_raccoon": true, + "tengu_amber_redwood2": "", + "tengu_doorbell_agave": false, + "tengu_swann_brevity": "focused", + "tengu_classifier_disabled_surfaces": "", + "tengu_cinder_plover": "", + "tengu_file_write_optimization": true, + "tengu_prism_ledger": false, + "tengu_basalt_spur": false, + "tengu_c4w_usage_limit_notifications_enabled": true, + "tengu_marble_sandcastle": false, + "tengu_trace_lantern": false, + "tengu_birch_compass": true, + "tengu_desktop_upsell_v2": { + "enabled": false + }, + "tengu_log_datadog_events": true, + "tengu_hazel_osprey_floor": 75000, + "tengu_pewter_summit": true, + "tengu_amber_rokovoko": 0.2, + "tengu_sparrow_ledger": false, + "tengu_sage_compass2": { + "enabled": true + }, + "tengu_ultraplan_timeout_seconds": 5400, + "tengu_sepia_moth": false, + "tengu_lantern_hearth": "off", + "tengu_tab_read_sep": false, + "tengu_windows_credman": false, + "tengu_feature_claudified_template": false, + "tengu_velvet_static": true, + "tengu_quill_harbor": "acceptEdits", + "tengu_loud_sugary_rock2": false, + "tengu_basalt_tern": false + }, + "firstStartTime": "2026-05-06T03:06:04.304Z", + "opusProMigrationComplete": true, + "sonnet1m45MigrationComplete": true, + "seenNotifications": {}, + "migrationVersion": 13, + "userID": "7d61701f40d83c9cd513888f359544d66e9a0a81a3e8082fd68bdf0897b8eb19", + "changelogLastFetched": 1778036764386, + "claudeCodeFirstTokenDate": "2026-03-16T02:47:40.558902Z", + "hasCompletedOnboarding": true, + "lastOnboardingVersion": "2.1.129", + "cachedExperimentFeatures": [ + "tengu_amber_prism", + "tengu_cedar_inlet", + "tengu_coral_beacon", + "tengu_flint_harbor", + "tengu_mcp_subagent_prompt", + "tengu_orchid_mantis_v2", + "tengu_plank_river_frost", + "tengu_read_dedup_killswitch", + "tengu_tussock_oriole" + ], + "groveConfigCache": { + "a468bb23-ef26-430c-ba99-33fcb13b224c": { + "grove_enabled": true, + "timestamp": 1779771117862 + } + }, + "lastReleaseNotesSeen": "2.1.129", + "projects": { + "/home/node": { + "allowedTools": [], + "mcpContextUris": [], + "mcpServers": {}, + "enabledMcpjsonServers": [], + "disabledMcpjsonServers": [], + "hasTrustDialogAccepted": false, + "projectOnboardingSeenCount": 1, + "hasClaudeMdExternalIncludesApproved": false, + "hasClaudeMdExternalIncludesWarningShown": false, + "exampleFiles": [], + "lastGracefulShutdown": true, + "lastCost": 0, + "lastAPIDuration": 0, + "lastAPIDurationWithoutRetries": 0, + "lastToolDuration": 0, + "lastDuration": 1802249, + "lastLinesAdded": 0, + "lastLinesRemoved": 0, + "lastTotalInputTokens": 0, + "lastTotalOutputTokens": 0, + "lastTotalCacheCreationInputTokens": 0, + "lastTotalCacheReadInputTokens": 0, + "lastTotalWebSearchRequests": 0, + "lastModelUsage": {}, + "lastSessionId": "a35d7fc6-46ab-4f82-ad00-cc013c22a422", + "lastSessionMetrics": { + "frame_duration_ms_count": 60, + "frame_duration_ms_min": 0.08933199999955832, + "frame_duration_ms_max": 4.8925859999999375, + "frame_duration_ms_avg": 0.6829539666659116, + "frame_duration_ms_p50": 0.370852499999728, + "frame_duration_ms_p95": 2.300691550000112, + "frame_duration_ms_p99": 4.704050319999977 + }, + "lastHintSessionId": "9c4a7d92-e8cb-47c0-b341-d725695106ab", + "lastSessionFirstPrompt": "The editor on the MAM does not seem to be functioning, lets diagnose and fix it https://forge.wilddragon.net/zgaetano/wild-dragon", + "lastSessionModified": 1779201199377, + "lastFpsAverage": 0.03, + "lastFpsLow1Pct": 204.39 + } + }, + "penguinModeOrgEnabled": false, + "closedIssuesLastChecked": 1779574561797, + "clientDataCache": null, + "additionalModelOptionsCache": [], + "additionalModelCostsCache": {}, + "overageCreditGrantCache": { + "8d49cc62-f614-43b2-9d9a-7f8936e79653": { + "info": { + "available": false, + "eligible": false, + "granted": false, + "amount_minor_units": null, + "currency": null + }, + "timestamp": 1779574561941 + } + }, + "officialMarketplaceAutoInstallAttempted": true, + "officialMarketplaceAutoInstalled": true, + "claudeAiMcpEverConnected": [ + "claude.ai mcp-server", + "claude.ai Context7", + "claude.ai Gmail", + "claude.ai Google Drive", + "claude.ai Google Calendar", + "claude.ai ms365" + ], + "passesEligibilityCache": { + "8d49cc62-f614-43b2-9d9a-7f8936e79653": { + "eligible": true, + "referral_code_details": { + "code": "AOaXn7YPpQ", + "campaign": "claude_code_guest_pass_a47c", + "referral_link": "https://claude.ai/referral/AOaXn7YPpQ" + }, + "referrer_reward": { + "amount_minor_units": 1000, + "currency": "USD" + }, + "remaining_passes": 3, + "timestamp": 1779771114609 + } + }, + "cachedExtraUsageDisabledReason": "org_level_disabled", + "remoteControlUpsellSeenCount": 3, + "passesUpsellSeenCount": 0, + "hasVisitedPasses": false, + "passesLastSeenRemaining": 3, + "showSpinnerTree": false, + "skillUsage": { + "fewer-permission-prompts": { + "usageCount": 2, + "lastUsedAt": 1779539348728 + } + }, + "mcpServers": { + "wilddragon": { + "type": "http", + "url": "https://mcp.wilddragon.net/mcp", + "headers": { + "Authorization": "Bearer 4oi4NSxq4KYj49ZgA57f8CZi4la3NP8HGCm9cwsWZoc=" + } + } + }, + "oauthAccount": { + "accountUuid": "a468bb23-ef26-430c-ba99-33fcb13b224c", + "emailAddress": "zgaetano@wilddragon.net", + "organizationUuid": "8d49cc62-f614-43b2-9d9a-7f8936e79653", + "hasExtraUsageEnabled": false, + "billingType": "stripe_subscription", + "accountCreatedAt": "2026-01-10T14:54:28.096025Z", + "subscriptionCreatedAt": "2026-03-16T02:46:05.026170Z", + "ccOnboardingFlags": {}, + "claudeCodeTrialEndsAt": null, + "claudeCodeTrialDurationDays": null, + "seatTier": null, + "displayName": "Zac", + "organizationRole": "admin", + "workspaceRole": null, + "organizationName": "zgaetano@wilddragon.net's Organization", + "organizationType": "claude_max", + "organizationRateLimitTier": "default_claude_max_5x", + "userRateLimitTier": null + } +} \ No newline at end of file diff --git a/claude-data/backups/.claude.json.backup.1779851826586 b/claude-data/backups/.claude.json.backup.1779851826586 new file mode 100644 index 0000000..9aef735 --- /dev/null +++ b/claude-data/backups/.claude.json.backup.1779851826586 @@ -0,0 +1,612 @@ +{ + "numStartups": 24, + "tipsHistory": { + "new-user-warmup": 1, + "plan-mode-for-complex-tasks": 2, + "color-when-multi-clauding": 3, + "terminal-setup": 7, + "memory-command": 7, + "theme-command": 10, + "status-line": 15, + "prompt-queue": 16, + "enter-to-steer-in-relatime": 16, + "todo-list": 17, + "install-github-app": 18, + "install-slack-app": 22, + "permissions": 22, + "drag-and-drop-images": 23 + }, + "promptQueueUseCount": 4, + "btwUseCount": 1, + "cachedGrowthBookFeatures": { + "tengu_billiard_aviary": false, + "tengu_shale_finch": true, + "tengu_slate_siskin": { + "enabled": false, + "timeoutMs": 8000, + "throttleMs": 30000, + "summaryLineThreshold": 5 + }, + "tengu_noreread_q7m_velvet": false, + "tengu_quiet_basalt_echo": false, + "tengu_plum_vx3": true, + "tengu_feature_template": false, + "tengu_post_compact_survey": false, + "tengu_good_survey_transcript_ask_config": { + "probability": 0.5 + }, + "tengu_amber_sentinel": true, + "tengu_turtle_carbon": true, + "tengu_bridge_requires_action_details": true, + "tengu_streaming_tool_execution2": true, + "tengu-off-switch": { + "activated": false + }, + "tengu_chomp_inflection": true, + "tengu_vscode_review_upsell": false, + "tengu_tussock_oriole": false, + "tengu_flint_harbor": false, + "tengu_kairos_loop_prompt": true, + "tengu_harbor_prism": false, + "tengu_cobalt_lantern": true, + "tengu_ccr_bridge": true, + "tengu_grey_step2": { + "enabled": true, + "dialogTitle": "We recommend medium effort for Opus", + "dialogDescription": "Effort determines how long Claude thinks for when completing your task. We recommend medium effort for most tasks to balance speed and intelligence and maximize rate limits. Use ultrathink to trigger high effort when needed." + }, + "tengu_desktop_upsell": { + "enable_shortcut_tip": true, + "enable_startup_dialog": false + }, + "tengu_frond_boric": {}, + "tengu_harbor": true, + "tengu_orchid_mantis": false, + "tengu_mocha_barista": true, + "tengu_hazel_osprey_floor": 75000, + "claude_code_skills_dashboard_enabled_cli": false, + "tengu_amber_prism": true, + "tengu_bridge_min_version": { + "minVersion": "2.1.70" + }, + "tengu_slate_thimble": false, + "tengu_olive_hinge": "", + "tengu_sub_nomdrep_q7k": true, + "tengu_pewter_ledger": "OFF", + "tengu_lapis_finch": true, + "tengu_tool_search_unsupported_models": [ + "haiku" + ], + "tengu_vellum_lantern": false, + "tengu_basalt_spur": false, + "tengu_slate_harbor_experiment": false, + "tengu_plank_river_frost": "user_intent", + "tengu_maple_tide": false, + "tengu_moss_anchor": false, + "tengu_worktree_mode": true, + "tengu_ladder_mq7": false, + "tengu_willow_refresh_ttl_hours": 0, + "tengu_brick_follow": false, + "tengu_log_datadog_events": true, + "tengu_disable_bypass_permissions_mode": false, + "tengu_osprey_lantern": false, + "tengu_sotto_voce": true, + "tengu_slate_moth": false, + "tengu_startup_notice": "", + "tengu_auto_notice_once": true, + "tengu_vellum_siding": false, + "tengu_tern_alloy": "copy_a", + "tengu_fennel_kite": false, + "tengu_orchid_trellis": false, + "tengu_keybinding_customization_release": true, + "tengu_cork_lantern": false, + "tengu_bridge_poll_interval_ms": 0, + "tengu_slate_nexus": true, + "tengu_cinder_plover": "", + "tengu_mcp_elicitation": true, + "tengu_claudeai_mcp_connectors": true, + "tengu_prism_ledger": false, + "tengu_slim_subagent_claudemd": true, + "tengu_bridge_poll_interval_config": { + "poll_interval_ms_not_at_capacity": 2000, + "poll_interval_ms_at_capacity": 600000, + "heartbeat_interval_ms": 0, + "multisession_poll_interval_ms_not_at_capacity": 5000, + "multisession_poll_interval_ms_at_capacity": 60000, + "multisession_poll_interval_ms_partial_capacity": 5000, + "non_exclusive_heartbeat_interval_ms": 180000, + "session_keepalive_interval_ms": 0, + "session_keepalive_interval_v2_ms": 0 + }, + "tengu_passport_quail": false, + "tengu_velvet_cascade": {}, + "tengu_copper_bridge": true, + "tengu_marble_whisper2": true, + "tengu_blue_coaster": false, + "tengu_willow_census_ttl_hours": 24, + "tengu_cinder_almanac": true, + "tengu_crystal_beam": { + "budgetTokens": 0 + }, + "tengu_mcp_retry_failed_remote": false, + "tengu_shining_fractals": false, + "tengu_ccr_v2_send_events_cli": false, + "tengu_sage_compass": {}, + "tengu_crimson_echo": {}, + "tengu_kairos_loop_dynamic": true, + "tengu_ashen_kelp": true, + "tengu_ultraplan_timeout_seconds": 5400, + "tengu_tool_pear": false, + "tengu_dune_wren": false, + "tengu_chert_bezel": true, + "tengu_otk_slot_v1": false, + "tengu_gha_plugin_code_review": false, + "tengu_ember_trail": "0", + "tengu_quartz_vireo": "", + "tengu_kairos_input_needed_push": true, + "tengu_marble_sandcastle": false, + "tengu_orchid_mantis_v2": true, + "tengu_prompt_suggestion": true, + "tengu_quartz_heron": false, + "tengu_bg_attach_stall_ms": 5000, + "tengu_tangerine_ladder_boost": true, + "tengu_ccr_bundle_max_bytes": 104857600, + "tengu-top-of-feed-tip": { + "tip": "", + "color": "" + }, + "tengu_classifier_summary_heuristic_emit": true, + "tengu_willow_mode": "hint_v2", + "tengu_bridge_repl_v2": true, + "tengu_prompt_cache_diagnostics": true, + "tengu_1p_event_batch_config": { + "scheduledDelayMillis": 10000, + "maxExportBatchSize": 400, + "maxQueueSize": 8192, + "path": "/api/event_logging/v2/batch" + }, + "tengu_ccr_bridge_multi_session": true, + "tengu_workout2": true, + "tengu_copper_wren": false, + "tengu_trace_lantern": false, + "tengu_penguin_mode_promo": { + "discountPercent": 0, + "endDate": "Feb 16" + }, + "tengu_amber_wren": { + "targetedRangeNudge": true, + "maxTokens": 25000 + }, + "tengu_ultraplan_prompt_identifier": "visual_plan", + "tengu_sedge_lantern_holdback": false, + "tengu_ochre_hollow": false, + "tengu_code_diff_cli": true, + "tengu_velvet_moth": 0.2, + "tengu_steady_lantern": false, + "tengu_slate_meadow": true, + "tengu_pewter_lark": "off", + "tengu_amber_lynx": false, + "tengu_workflows_enabled": false, + "tengu_silk_hinge": false, + "tengu_scarf_coffee": false, + "tengu_kairos_cron": true, + "tengu_pewter_brook": false, + "tengu_cobalt_ridge": true, + "tengu_sparrow_ledger": false, + "tengu_herring_clock": false, + "tengu_canary": {}, + "tengu_compact_cache_prefix": true, + "tengu_quiet_slate_wren": false, + "tengu_marble_whisper": true, + "tengu_penguins_enabled": true, + "tengu_cobalt_heron": false, + "tengu_fennel_kite_model": "", + "tengu_plugin_official_mkt_git_fallback": true, + "tengu_cedar_inlet": "off", + "tengu_bad_survey_transcript_ask_config": { + "probability": 1 + }, + "tengu_destructive_command_warning": false, + "tengu_scratch": false, + "tengu_lichen_compass": false, + "tengu_pewter_lantern": false, + "tengu_coral_beacon": true, + "tengu_prompt_cache_1h_config": { + "allowlist": [ + "repl_main_thread*", + "sdk", + "auto_mode", + "rolling_compact", + "memdir_relevance", + "agent_classifier", + "prompt_suggestion", + "away_summary", + "extract_memories" + ] + }, + "tengu_snippet_save": false, + "tengu_classifier_summary_llm_emit": true, + "tengu_marble_anvil": true, + "tengu_marble_lark": false, + "tengu_fgts": true, + "tengu_desktop_upsell_v2": { + "enabled": false + }, + "tengu_dunwich_bell": false, + "tengu_harbor_permissions": true, + "tengu_session_memory": false, + "tengu_system_prompt_global_cache": true, + "tengu_chair_sermon": false, + "tengu_auto_mode_default_on": false, + "tengu_harbor_willow": false, + "tengu_crimson_vector": false, + "tengu_miraculo_the_bard": false, + "tengu_satin_quoll": {}, + "tengu_ccr_post_turn_summary": false, + "tengu_skills_dashboard_enabled": false, + "tengu_sepia_cormorant": [], + "tengu_slate_harrier": "off", + "tengu_read_dedup_killswitch": false, + "tengu_amber_redwood2": "", + "tengu_anchor_tide": false, + "tengu_feedback_survey_config": { + "minTimeBeforeFeedbackMs": 600000, + "minTimeBetweenFeedbackMs": 43200000, + "minTimeBetweenGlobalFeedbackMs": 43200000, + "minUserTurnsBeforeFeedback": 5, + "minUserTurnsBetweenFeedback": 25, + "hideThanksAfterMs": 3000, + "onForModels": [ + "*" + ], + "probability": 0.05 + }, + "tengu_version_config": { + "minVersion": "1.0.24" + }, + "tengu_c4w_usage_limit_notifications_enabled": true, + "tengu_timber_lark": "copy_a", + "tengu_amber_rokovoko": 0.2, + "tengu_coral_fern": false, + "tengu_collage_kaleidoscope": true, + "tengu_sepia_moth": false, + "tengu_drift_lantern": false, + "tengu_moth_copse": false, + "tengu_kairos_cron_durable": false, + "tengu_ember_latch": true, + "tengu_bramble_lintel": 7, + "tengu_file_write_optimization": true, + "tengu_umber_petrel": false, + "tengu_slate_wren": false, + "tengu_red_coaster": false, + "tengu_sage_compass2": { + "enabled": true + }, + "tengu_copper_fox": false, + "tengu_orford_ness": false, + "tengu_lapis_thicket": false, + "tengu_onyx_plover": { + "enabled": false, + "minHours": 24, + "minSessions": 3, + "remoteEnabled": false + }, + "tengu_fg_left_arrow_agents": false, + "tengu_vscode_onboarding": false, + "tengu_sedge_lantern": true, + "tengu_kestrel_arch": "OFF", + "tengu_gouda_loop": true, + "tengu_walrus_canteen": false, + "tengu_nimble_amber_prose": false, + "tengu_slate_finch": false, + "tengu_cobalt_compass": true, + "tengu_gypsum_kite": false, + "tengu_hazel_osprey": false, + "tengu_bridge_attestation_enforce": false, + "tengu_amber_heron": false, + "tengu_hawthorn_steeple": false, + "tengu_cobalt_wren": false, + "tengu_agent_list_attach": false, + "tengu_harbor_ledger": [ + { + "marketplace": "claude-plugins-official", + "plugin": "discord" + }, + { + "marketplace": "claude-plugins-official", + "plugin": "telegram" + }, + { + "marketplace": "claude-plugins-official", + "plugin": "fakechat" + }, + { + "marketplace": "claude-plugins-official", + "plugin": "imessage" + } + ], + "tengu_malort_pedway": { + "enabled": true, + "pixelValidation": false, + "clipboardPasteMultiline": true, + "screenshotFilter": true, + "mouseAnimation": true, + "hideBeforeAction": true, + "autoTargetDisplay": false, + "coordinateMode": "pixels" + }, + "tengu_max_version_config": {}, + "tengu_event_sampling_config": {}, + "tengu_cobalt_raccoon": true, + "tengu_willow_sentinel_ttl_hours": 1, + "tengu_pewter_summit": true, + "tengu_review_bughunter_config": { + "fleet_size": 5, + "max_duration_minutes": 10, + "agent_timeout_seconds": 600, + "total_wallclock_minutes": 22, + "model": "claude-opus-4-7", + "cost_note": "$5-$25", + "duration_note": "~5-10 min", + "enabled": true + }, + "tengu_doorbell_agave": false, + "tengu_quiet_harbor": false, + "tengu_immediate_model_command": false, + "tengu_sessions_elevated_auth_enforcement": false, + "tengu_surreal_dali": true, + "tengu_amber_lark": false, + "tengu_slate_ribbon": true, + "tengu_ccr_bundle_seed_enabled": true, + "tengu_flint_harbor_prompt": { + "prompt": "You are helping a power user generate an onboarding guide for teammates who are new to Claude Code. The guide will live in the team's onboarding docs and can be pasted into Claude for an interactive walkthrough.\n\nYou're co-authoring this with them — collaborative and helpful, like a teammate who's done this before and is happy to share.\n\n## Usage data (last {{WINDOW_DAYS}} days)\n\nThis was scanned from the guide creator's local Claude Code transcripts:\n\n```json\n{{USAGE_DATA}}\n```\n\n## Your task\n\nBefore anything else — including before thinking through the classification — output exactly this line as your first visible text:\n\n> Looking at how you've used Claude over the last {{WINDOW_DAYS}} days to put together an onboarding guide for teammates new to Claude Code.\n\nThis must come before any extended thinking about session descriptors. The guide creator is staring at a blank screen until you do. Classification is step 2, not step 1.\n\nGenerate the guide immediately, then ask for revisions. Don't wait for answers first — it's easier for the guide creator to edit a concrete draft than answer abstract questions.\n\n1. **Output the acknowledgment line above.** No thinking, no classification, no tool calls before this. One line, then move on.\n\n2. **Derive the work-type breakdown.** Read the `sessionDescriptors` array — each entry describes one session via its title, any linked code reviews (`prNumbers`), and first user message. Classify each session into one of these task types:\n\n - **build_feature** — new functionality, scripts, tools, config/CI/env setup\n - **debug_fix** — investigating and fixing bugs\n - **improve_quality** — refactoring, tests, cleanup, code review\n - **analyze_data** — queries, metrics, number crunching\n - **plan_design** — architecture, approach, strategy, understanding unfamiliar code, design review\n - **prototype** — spikes, POCs, throwaway exploration\n - **write_docs** — PRDs, RFCs, READMEs, design docs, copy/doc review\n\n Categories describe the *type of task*, not the project or domain — a teammate on any project should recognize them. Review sessions belong with whatever's being reviewed: code review is improve_quality, doc review is write_docs, design review is plan_design. Most sessions fit the list; only invent a new category if it's genuinely a different type of task. Pick the top 3-5 with rough percentages. First messages alone are usually enough; titles and code-review links are enrichment. If first messages are uninformative, use tool and MCP counts as a weak hint. If there are ~0 sessions, leave the breakdown as a TODO.\n\n In the rendered guide, display categories with spaces and title case (e.g. \"Build Feature\" not \"build_feature\").\n\n3. **Gather the remaining pieces.** For repos, start with `currentRepo` and check the workspace for sibling repo directories. For MCP server setup, use each entry's `name` (and `urlOrigin` where present) to infer what the server does and how a teammate would get access. Leave the Team Tips and Get Started sections as TODO placeholders — you'll ask for these in Review and fill them in after.\n\n4. **Write the guide to `ONBOARDING.md`** following this template:\n\n```\n{{GUIDE_TEMPLATE}}\n```\n\n Fill in real numbers from the usage data (not placeholders). Use `generatedBy` for the name; if it's missing, omit the name. Ascii bar charts: `█` for filled, `░` for empty, 20 chars wide. Keep the HTML comment instruction at the bottom exactly as shown.\n\n5. **Render the guide in a code block, then close out the first turn.** You're co-authoring this guide with the guide creator — frame the follow-up as collaboration, not corrections.\n\n After the code block, add a `---` horizontal rule and a `**Review**` heading so the guide is visually separated from your questions. Under the heading, number these three questions:\n\n 1. \"I went with '[X]' for the team name — let me know if that sounds right.\" (or if you couldn't tell: \"What's the team name? I'll add it in.\")\n 2. Is there a starter task for someone new to Claude Code? (ticket or doc link — optional)\n 3. Any team tips you'd tell a new teammate that aren't already in CLAUDE.md?\n\n After they answer, update `ONBOARDING.md` with their team name, tips, and starter task. Then close with this exact line (not numbered, not paraphrased):\n\n Saved to `ONBOARDING.md`. Drop it in your team docs and channels — when a new teammate pastes it into Claude Code, they get a guided onboarding tour from there.\n\n Apply any edits they come back with to the file.", + "guideTemplate": "# Welcome to [Team Name]\n\n## How We Use Claude\n\nBased on [name]'s usage over the last [N] days:\n\nWork Type Breakdown:\n [Category 1] [ascii bar] [N]%\n [Category 2] [ascii bar] [N]%\n [Category 3] [ascii bar] [N]%\n ...\n\nTop Skills & Commands:\n [/command] [ascii bar] [N]x/month\n ...\n\nTop MCP Servers:\n [Server] [ascii bar] [N] calls\n ...\n\n## Your Setup Checklist\n\n### Codebases\n- [ ] [repo-name] — [repo url]\n...\n\n### MCP Servers to Activate\n- [ ] [Server] — [what it's for]. [How to get access]\n...\n\n### Skills to Know About\n- [/command] — [what it does, when the team uses it]\n...\n\n## Team Tips\n\n_TODO_\n\n## Get Started\n\n_TODO_\n\n", + "windowDays": 30 + }, + "tengu_loud_sugary_rock": false, + "tengu_ultraplan_config": { + "enabled": true + }, + "tengu_permission_friction": true, + "tengu_hawthorn_window": 200000, + "tengu_garnet_finch": false, + "tengu_porch_bell_9f": "", + "tengu_birthday_hat": false, + "tengu_tide_elm": "off", + "tengu_slate_kestrel": true, + "tengu_auto_mode_config": { + "enabled": "enabled", + "twoStageClassifier": true + }, + "tengu_negative_interaction_transcript_ask_config": { + "probability": 0 + }, + "tengu_loggia_carousel": false, + "tengu_classifier_disabled_surfaces": "", + "tengu_swann_brevity": "focused", + "tengu_cedar_halo": false, + "tengu_amber_lattice": { + "plugins": [ + "security-guidance", + "code-review", + "commit-commands", + "code-simplifier", + "hookify", + "feature-dev", + "frontend-design", + "pr-review-toolkit", + "skill-creator", + "plugin-dev", + "agent-sdk-dev", + "mcp-server-dev", + "claude-code-setup", + "claude-md-management", + "playground", + "ralph-loop", + "explanatory-output-style", + "learning-output-style", + "clangd-lsp", + "csharp-lsp", + "gopls-lsp", + "jdtls-lsp", + "kotlin-lsp", + "lua-lsp", + "php-lsp", + "pyright-lsp", + "ruby-lsp", + "rust-analyzer-lsp", + "swift-lsp", + "typescript-lsp" + ] + }, + "tengu_pewter_kestrel": { + "global": 50000, + "Bash": 30000, + "PowerShell": 30000, + "Grep": 20000, + "Snip": 1000, + "StrReplaceBasedEditTool": 30000, + "BashSearchTool": 20000 + }, + "tengu_mcp_singleton_unwrap": true, + "tengu_birch_compass": true, + "tengu_mcp_subagent_prompt": true, + "tengu_amber_flint": true, + "tengu_gleaming_fair": true, + "tengu_team_discovery": false, + "tengu_cork_m4q": true, + "tengu_velvet_ibis": {}, + "tengu_idle_amber_finch": false, + "tengu_sm_config": { + "minimumMessageTokensToInit": 150000, + "minimumTokensBetweenUpdate": 40000, + "toolCallsBetweenUpdates": 10 + }, + "tengu_flint_harbor_share": false, + "tengu_jade_anvil_4": false, + "tengu_react_vulnerability_warning": false, + "tengu_kairos_push_notifications": true, + "tengu_bridge_repl_v2_config": { + "init_retry_max_attempts": 3, + "init_retry_base_delay_ms": 500, + "init_retry_jitter_fraction": 0.25, + "init_retry_max_delay_ms": 4000, + "http_timeout_ms": 10000, + "uuid_dedup_buffer_size": 2000, + "heartbeat_interval_ms": 20000, + "heartbeat_jitter_fraction": 0.1, + "token_refresh_buffer_ms": 600000, + "teardown_archive_timeout_ms": 1500, + "connect_timeout_ms": 15000, + "min_version": "2.1.70", + "should_show_app_upgrade_message": false + }, + "tengu_maple_pier": false, + "tengu_amber_anchor": false, + "tengu_lantern_hearth": "off", + "tengu_basalt_tern": false, + "tengu_windows_credman": false, + "tengu_feature_claudified_template": false, + "tengu_quill_harbor": "acceptEdits", + "tengu_loud_sugary_rock2": false, + "tengu_tab_read_sep": false, + "tengu_velvet_static": true + }, + "firstStartTime": "2026-05-06T03:06:04.304Z", + "opusProMigrationComplete": true, + "sonnet1m45MigrationComplete": true, + "seenNotifications": {}, + "migrationVersion": 13, + "userID": "7d61701f40d83c9cd513888f359544d66e9a0a81a3e8082fd68bdf0897b8eb19", + "changelogLastFetched": 1778036764386, + "claudeCodeFirstTokenDate": "2026-03-16T02:47:40.558902Z", + "hasCompletedOnboarding": false, + "lastOnboardingVersion": "2.1.129", + "cachedExperimentFeatures": [ + "tengu_amber_prism", + "tengu_cedar_inlet", + "tengu_coral_beacon", + "tengu_flint_harbor", + "tengu_mcp_subagent_prompt", + "tengu_orchid_mantis_v2", + "tengu_plank_river_frost", + "tengu_read_dedup_killswitch", + "tengu_tussock_oriole" + ], + "groveConfigCache": { + "a468bb23-ef26-430c-ba99-33fcb13b224c": { + "grove_enabled": true, + "timestamp": 1779771117862 + } + }, + "lastReleaseNotesSeen": "2.1.129", + "projects": { + "/home/node": { + "allowedTools": [], + "mcpContextUris": [], + "mcpServers": {}, + "enabledMcpjsonServers": [], + "disabledMcpjsonServers": [], + "hasTrustDialogAccepted": false, + "projectOnboardingSeenCount": 1, + "hasClaudeMdExternalIncludesApproved": false, + "hasClaudeMdExternalIncludesWarningShown": false, + "exampleFiles": [], + "lastGracefulShutdown": true, + "lastCost": 0, + "lastAPIDuration": 0, + "lastAPIDurationWithoutRetries": 0, + "lastToolDuration": 0, + "lastDuration": 8913, + "lastLinesAdded": 0, + "lastLinesRemoved": 0, + "lastTotalInputTokens": 0, + "lastTotalOutputTokens": 0, + "lastTotalCacheCreationInputTokens": 0, + "lastTotalCacheReadInputTokens": 0, + "lastTotalWebSearchRequests": 0, + "lastModelUsage": {}, + "lastSessionId": "983b53e3-0710-4e16-8491-503b725ae30e", + "lastSessionMetrics": { + "frame_duration_ms_count": 58, + "frame_duration_ms_min": 0.07787199999984296, + "frame_duration_ms_max": 21.08254399999987, + "frame_duration_ms_avg": 1.7625146034482189, + "frame_duration_ms_p50": 0.6402524999996331, + "frame_duration_ms_p95": 6.405088350000184, + "frame_duration_ms_p99": 15.233133890000012 + }, + "lastHintSessionId": "9c4a7d92-e8cb-47c0-b341-d725695106ab", + "lastSessionFirstPrompt": "The editor on the MAM does not seem to be functioning, lets diagnose and fix it https://forge.wilddragon.net/zgaetano/wild-dragon", + "lastSessionModified": 1779201199377, + "lastFpsAverage": 6.89, + "lastFpsLow1Pct": 47.43 + } + }, + "penguinModeOrgEnabled": false, + "closedIssuesLastChecked": 1779830191762, + "clientDataCache": null, + "additionalModelOptionsCache": [], + "additionalModelCostsCache": {}, + "overageCreditGrantCache": { + "8d49cc62-f614-43b2-9d9a-7f8936e79653": { + "info": { + "available": false, + "eligible": false, + "granted": false, + "amount_minor_units": null, + "currency": null + }, + "timestamp": 1779830191895 + } + }, + "officialMarketplaceAutoInstallAttempted": true, + "officialMarketplaceAutoInstalled": true, + "claudeAiMcpEverConnected": [ + "claude.ai mcp-server", + "claude.ai Context7", + "claude.ai Gmail", + "claude.ai Google Drive", + "claude.ai Google Calendar", + "claude.ai ms365" + ], + "passesEligibilityCache": { + "8d49cc62-f614-43b2-9d9a-7f8936e79653": { + "eligible": true, + "referral_code_details": { + "code": "AOaXn7YPpQ", + "campaign": "claude_code_guest_pass_a47c", + "referral_link": "https://claude.ai/referral/AOaXn7YPpQ" + }, + "referrer_reward": { + "amount_minor_units": 1000, + "currency": "USD" + }, + "remaining_passes": 3, + "timestamp": 1779771114609 + } + }, + "cachedExtraUsageDisabledReason": "org_level_disabled", + "remoteControlUpsellSeenCount": 3, + "passesUpsellSeenCount": 0, + "hasVisitedPasses": false, + "passesLastSeenRemaining": 3, + "showSpinnerTree": false, + "skillUsage": { + "fewer-permission-prompts": { + "usageCount": 2, + "lastUsedAt": 1779539348728 + } + }, + "mcpServers": { + "wilddragon": { + "type": "http", + "url": "https://mcp.wilddragon.net/mcp", + "headers": { + "Authorization": "Bearer 4oi4NSxq4KYj49ZgA57f8CZi4la3NP8HGCm9cwsWZoc=" + } + } + }, + "subscriptionNoticeCount": 0, + "hasAvailableSubscription": false +} diff --git a/claude-data/backups/.claude.json.backup.1779933879680 b/claude-data/backups/.claude.json.backup.1779933879680 new file mode 100644 index 0000000..cbce59c --- /dev/null +++ b/claude-data/backups/.claude.json.backup.1779933879680 @@ -0,0 +1,3 @@ +{ + "firstStartTime": "2026-05-28T02:04:39.671Z" +} \ No newline at end of file diff --git a/claude-data/cache/changelog.md b/claude-data/cache/changelog.md new file mode 100644 index 0000000..59203c1 --- /dev/null +++ b/claude-data/cache/changelog.md @@ -0,0 +1,4021 @@ +# Changelog + +## 2.1.153 + +- Added `skipLfs` option to `github`/`git` plugin marketplace sources to skip Git LFS downloads during clone and update +- Claude Code now shows a one-time notice when your npm global install can't auto-update; `/doctor` lists the fixes +- Status line commands now receive `COLUMNS` and `LINES` environment variables so scripts can size output to the terminal width +- `claude agents`: autocomplete in the dispatch input now suggests native slash commands and bundled skills, not just project skills +- `claude agents`: PR column now shows `PR #N` for a single PR or `N PRs` for multiple +- `claude doctor` now shows the result of your last update attempt +- Combined the separate "needs authentication" startup notifications for MCP servers and connectors into a single message +- macOS: background agents now appear as "Claude Code" in Privacy & Security and keep their permission grants across upgrades +- Fixed stateful MCP servers without the optional GET SSE stream reconnect-looping on `tools/list` (regression in v2.1.147) +- Fixed a regression where a custom API gateway could receive the user's Anthropic OAuth credential instead of the gateway's own token +- Fixed subagent (Agent tool) frontmatter MCP servers ignoring `--strict-mcp-config`, `--bare`, remote mode, enterprise managed MCP config, and managed-settings MCP server allow/deny policies +- `--strict-mcp-config` no longer strips inline `mcpServers` from explicitly-passed agent definitions (`--agents` / SDK `agents`), and blocked subagent MCP servers now surface a visible warning +- Fixed the Windows PowerShell installer reporting "Installation complete!" when installation actually failed +- Fixed `claude update` installing the latest version instead of the configured release channel's version for npm installations +- Fixed excessive memory usage (multiple GB) when resuming a session by transcript file path on machines with many stored sessions +- Fixed `claude agents` and `claude --bg` running on a stale daemon started before binary-takeover support, even after upgrading +- Fixed a hang where the CLI could fail to exit when stdin was closed without EOF in stream-json mode, leaving a stale session marker behind +- Fixed malformed `file://` links in Claude's responses not being clickable in the terminal +- Fixed `claude --help` rendering unwrapped output on terminals narrower than 92 columns +- Fixed MCP tool progress notifications not rendering in the collapsed tool view +- Fixed `Agent` tool with `subagent_type: 'claude'` running in an undocumented temporary worktree, which could silently discard outputs written to gitignored paths +- `/bg` while Claude is responding now continues the response in the background session instead of dropping it +- Fixed `/btw` keyboard shortcuts becoming unresponsive in background sessions while a task is running +- Fixed background sessions writing temp files to `$CLAUDE_JOB_DIR` triggering a "sensitive file" permission prompt +- Fixed recovering a background agent whose working directory was deleted showing a truncated stack trace instead of a clear error message +- Fixed `EnterWorktree` not being available immediately in background sessions (previously required `ToolSearch` first) +- Fixed `cmd+k` in iTerm2/Terminal.app not repainting attached background sessions +- Fixed the IME candidate window appearing at the bottom of the screen instead of next to the input caret in attached background sessions on Windows +- Fixed background-color bleed when attaching to a background agent from 256-color-only terminals after the agent had rendered file diffs +- Fixed `/copy` and copy-on-select silently failing to update the system clipboard when attached to a background session inside tmux +- Fixed opening `claude agents` with Remote Control enabled leaving zombie session entries on the Code tab after exiting +- Fixed `/rename` in background sessions not updating the session banner immediately +- Fixed Windows update rollback: if a Windows update fails, Claude Code now restores the original executable by copy and tells you how to recover +- [VSCode] Fixed Claude Code processes not shutting down cleanly when VS Code closed on Windows, causing false "unclean exit" reports and orphaned MCP servers +- `/model` now saves your selection as the default for new sessions (matching the IDE). Press `s` in the picker to switch models for the current session only. +- If you customized the `modelPicker:setAsDefault` keybinding, rename it to `modelPicker:thisSessionOnly` in keybindings.json (the `d` action was replaced by `s`) + +## 2.1.152 + +- `/code-review --fix` now applies review findings to your working tree after the review, surfacing reuse, simplification, and efficiency suggestions; `/simplify` now invokes `/code-review --fix` +- Skills and slash commands can now set `disallowed-tools` in frontmatter to remove tools from the model while the skill is active +- Added `/reload-skills` command to re-scan skill directories without restarting the session +- `SessionStart` hooks can now return `reloadSkills: true` to re-scan skill directories, making skills installed by the hook available in the same session +- `SessionStart` hooks can now set the session title via `hookSpecificOutput.sessionTitle` on startup and resume +- Added a `MessageDisplay` hook event that lets hooks transform or hide assistant message text as it is displayed +- Added `pluginSuggestionMarketplaces` managed setting: admins can allowlist org marketplaces whose plugins may be suggested via context-aware tips +- `claude plugin marketplace remove` now accepts `--scope user|project|local` for symmetry with `marketplace add`, `install`, and `uninstall` +- Claude Code now switches to your configured `--fallback-model` for the rest of the session when the primary model is not found, instead of failing every request +- Auto mode no longer requires opt-in consent +- Vim mode: `/` in NORMAL mode now opens reverse history search (like Ctrl+R), matching bash/zsh vi-mode +- The `/usage` breakdown now includes large session files; files are scanned with a streaming read so memory usage stays flat +- Thinking summaries in the collapsed group now stay readable for at least 3 seconds, render as markdown, and cap at 10 lines (`Ctrl+O` shows the full thinking) +- In fullscreen mode, the "Thinking for Ns" indicator now counts up live while the model is thinking, and keeps its value if you interrupt mid-thought +- Simplified the Workflow tool's inline progress display — live agent counts now show only in the persistent workflow status row below the prompt +- The post-response timer now shows "Waiting for N background agents/workflows to finish" when backgrounded agents or workflows are still running, and reports the cumulative time once their results are processed +- Added the session entrypoint as an OpenTelemetry metric attribute (`app.entrypoint`, opt-in via `OTEL_METRICS_INCLUDE_ENTRYPOINT=true`) +- Fixed terminal styling degrading in very long sessions by recycling the renderer's style pool +- Fixed the sandbox-enabled warning not appearing in condensed startup mode — it now shows in every layout +- Fixed the loading spinner showing "still thinking"/"almost done thinking" while a tool is running, and reset the thinking status to "thinking" after each tool +- Fixed focus mode showing a spurious "N messages hidden" count on turns with no hidden activity +- Fixed clicking a link inside an expanded tool result collapsing the section instead of opening the link +- Fixed markdown table cell borders inheriting the color of inline code, wrapped continuation lines losing their style, and empty header cells showing a label in the narrow-terminal stacked layout +- Fixed plugin MCP servers with the same command but different environment variables being incorrectly deduplicated +- Fixed `/doctor` reporting "marketplace not found" or "plugin not found" for stale `enabledPlugins` entries referencing removed marketplaces or dropped plugins +- Fixed plugins that track a git branch silently no longer receiving updates after the plugin registry was rebuilt +- Fixed remote MCP servers failing to connect in Claude Code Remote sessions when the egress proxy is enabled +- Fixed the effort-change confirmation dialog appearing when the conversation has no messages or when switching between effort levels that resolve to the same underlying value +- Fixed the Agent tool description referencing an agent list that is never delivered when running with `--bare` or with attachments disabled +- Fixed a background worker crash in `claude agents` when accepting a stale permission prompt after a subagent was cancelled +- Fixed `cache_creation_input_tokens` reporting as 0 in transcript and result usage when the API reports cache writes only via the nested `cache_creation` breakdown +- Fixed the PushNotification tool incorrectly reporting "Mobile push not sent (Remote Control inactive)" in SDK-hosted sessions when Remote Control is enabled +- Fixed sessions getting stuck after a model or login switch left stale thinking-block signatures in history; now stripped proactively with a retry safety-net + +## 2.1.150 + +- Internal infrastructure improvements (no user-facing changes) + +## 2.1.149 + +- `/usage` now shows a per-category breakdown of what's driving your limits usage — skills, subagents, plugins, and per-MCP-server cost +- `/diff` detail view can now be scrolled with the keyboard (arrows, `j`/`k`, `PgUp`/`PgDn`, `Space`, `Home`/`End`) +- Markdown output now renders GFM task list checkboxes (`- [ ] todo` / `- [x] done`) instead of plain bullets +- Enterprise: added the `allowAllClaudeAiMcps` managed setting to load claude.ai cloud MCP connectors alongside `managed-mcp.json` +- Fixed a PowerShell permission bypass: built-in `cd` functions (`cd..`, `cd\`, `cd~`, `X:`) changed the working directory undetected, letting a later command read outside the workspace +- Fixed the sandbox write allowlist in git worktrees covering the entire main repository root instead of only the shared `.git` directory (with `hooks/` and `config` denied) +- Fixed PowerShell prefix/wildcard allow rules (e.g. `PowerShell(dotnet.exe build *)`) not pre-approving native executables and scripts +- Fixed a permission-analysis gap where the parser trusted stale variable-tracking values for `PWD`/`OLDPWD`/`DIRSTACK` across `cd`/`pushd`/`popd` +- Fixed `find` in the Bash tool exhausting the macOS system file/vnode table and crashing the host on large directory trees +- Fixed the managed-settings approval dialog leaving the terminal frozen after accepting at startup +- Fixed `/ultraplan` and remote session creation failing with "Could not capture uncommitted changes" when the working tree has no real changes +- Fixed `otelHeadersHelper` failing silently when the script path contains spaces; helper failures are now reported in `/doctor` and the debug log +- Fixed the thinking spinner staying amber across tool calls and onto fresh thinking bursts +- Fixed collapsed Bash output reporting the wrong hidden-line count for outputs with many short lines +- Fixed slash-command argument-hint clipping trailing typed characters when the hint overflows the input box +- Fixed argument-hint and progressive arg suggestions not appearing after Tab-completing a skill whose frontmatter `name:` differs from its directory basename +- Fixed the status bar showing the user's baseline `/effort` setting instead of the effort level applied by skill/agent `effort:` frontmatter +- Fixed Ctrl+O transcript view freezing at the moment it was opened instead of tailing new messages +- Fixed editing a recalled prompt-history entry losing the edit when navigating further up/down with arrow keys +- Fixed `/config` exit summary reporting phantom changes to auto-compact and theme when toggling unrelated settings +- Fixed `/insights` crashing when cached session-meta files are missing optional fields +- Fixed malformed PowerShell and History tool calls with missing input being misclassified as reads in transcript collapsing +- Fixed renaming a Remote Control session from claude.ai or the Claude mobile app not updating the local session name for `claude --resume` +- Fixed a race where a just-submitted prompt could appear twice in the up-arrow history +- Fixed tapping the "Jump to bottom" pill in fullscreen mode not dismissing it immediately +- Improved `/feedback` reports to include the conversation that happened before context compaction, making issues from earlier in long sessions easier to triage + +## 2.1.148 + +- Fixed the Bash tool returning exit code 127 on every command for some users (a regression introduced in 2.1.147) + +## 2.1.147 + +- Pinned background sessions (`Ctrl+T` in `claude agents`) now stay alive when idle, are restarted in place to apply Claude Code updates, and are shed under memory pressure only after non-pinned sessions +- Renamed `/simplify` to `/code-review`. It now reports correctness bugs at a chosen effort level (e.g., `/code-review high`); pass `--comment` to post findings as inline GitHub PR comments. The old cleanup-and-fix behavior has been removed +- Improved auto-updater: retries transient network failures, reports specific error categories and OS error codes on failure, and shows the current version when an update fails +- Improved diff rendering performance for large file edits +- Prompt history no longer records consecutive duplicate entries — recalling a prompt with arrow-up and submitting it again won't add another copy +- Fixed enterprise login restrictions (`forceLoginOrgUUID` and `forceLoginMethod` managed-settings) not being enforced against third-party-provider and API-key sessions +- Fixed `&` in `!` command output displaying as `&`, which broke copy-pasting URLs from commands like `gcloud auth login` on headless machines +- Fixed unknown slash commands silently doing nothing in headless/SDK mode — they now show an error message +- Fixed `/help` rendering a broken tab header and showing only one command per page on small terminals when not in fullscreen mode +- Fixed shell snapshot dropping user functions whose names start with a single underscore, which broke aliases referencing them +- Fixed plugin agents that declare multiple `Agent(...)` types in `tools:` frontmatter dropping all but the last entry +- Fixed hook `if` conditions like `PowerShell(git push*)` never matching — only `PowerShell(*)` worked +- Fixed PowerShell tool dropping output for commands that rely on the default formatter +- Fixed: on Windows, "Yes, and don't ask again" for a PowerShell script invocation now writes a rule that actually matches on subsequent runs +- Fixed PowerShell tool failing on Windows with exit code 1 when `pwsh` is installed via winget or the Microsoft Store +- Fixed `/effort` opening with the slider on the wrong level — it now starts at your current effort +- Fixed paginating MCP servers dropping resources, templates, and prompts past page 1 +- Fixed full-screen strobing in attached background sessions on Windows Terminal while Claude is streaming +- Fixed: on Windows, removing a background-job worktree no longer follows NTFS junctions into the main repo +- Fixed `/background` refusing sessions whose only typed input was a skill or custom slash command +- Fixed auto mode suppressing `AskUserQuestion` when the user or a skill explicitly relies on it; the auto-mode classifier now sees the user's answers as intent signal +- Fixed `/theme` "New custom theme" and color editor dialogs not responding to Esc +- Fixed an uncaught exception at the end of streaming sessions when running via the Agent SDK +- Fixed a rare hang when waiting for scroll to settle on Windows +- Fixed stale and doubled rows in the agent view list on Windows when background session results contain wide (CJK) characters +- Fixed pasted text being delivered to agents as an unreadable `[Pasted text #N]` placeholder instead of the actual content +- Fixed plugin component counts in `claude plugin details` and `/plugin` being doubled when a plugin's manifest listed paths overlapping its default directories +- Fixed backgrounded sessions re-prompting for tool permissions you already granted with "don't ask again" +- Fixed GNOME Terminal right-click and middle-click paste not inserting text +- Fixed `CLAUDE_CODE_SUBAGENT_MODEL` not applying to teammate processes spawned by agent teams +- Fixed slash commands followed by a tab or newline being treated as an unknown command +- Fixed several spacing and layout glitches in the `/plugin`, `/status`, `/mobile`, `/sandbox`, and `/permissions` menus +- Fixed stripped images prompting the model to repeatedly re-read media that was no longer present + +## 2.1.145 + +- Added `claude agents --json` to list live Claude sessions as JSON for scripting (tmux-resurrect, status bars, session pickers) +- Added `agent_id` and `parent_agent_id` attributes to `claude_code.tool` OTEL spans, and fixed trace parenting so background subagent spans nest under the dispatching Agent tool span +- Status line JSON input now includes GitHub repo and PR information when detected +- `/plugin` Discover and Browse screens now show a plugin's commands, agents, skills, hooks, and MCP/LSP servers before installation +- `claude agents` terminal tab title now shows the awaiting-input count so an alt-tabbed window tells you when an agent needs attention +- Slash command and @-mention suggestion list now supports mouse hover and click in fullscreen mode +- Stop and SubagentStop hook input now includes `background_tasks` and `session_crons` fields +- Fixed a permission-prompt bypass where bare variable assignments to non-allowlisted environment variables in Bash commands were auto-approved +- Fixed MCP prompt slash commands showing raw server validation errors when a required argument is omitted — the error now names the missing argument and shows expected usage +- Fixed the spinner and elapsed-time display freezing until a keypress after the terminal was resized or refocused +- Fixed the cross-project resume hint failing in default Windows PowerShell 5.1 — Windows now uses `;` as the command separator +- Fixed voice push-to-talk not working in the agent view's reply pane +- Fixed task lists rendering in random order when several tasks are created at once +- Fixed stale "Failed to install Anthropic marketplace" banner showing when the marketplace is already installed +- Fixed the PR badge in the footer not updating immediately after `gh pr create` and other PR-state-changing commands run in-session +- Fixed Agent Teams teammates with non-ASCII names failing every API call due to invalid header encoding +- Fixed `/review` using a deprecated `projectCards` GraphQL query that errored on repos with Classic Projects +- Fixed `claude plugin validate` not flagging `skills:` entries that point at a file instead of a directory — the error now suggests the parent directory +- Fixed an infinite loop where a skill using `context: fork` could repeatedly re-invoke itself instead of running +- Improved the Read tool to return a truncated first page with a "PARTIAL view" notice instead of a hard error when a whole-file read exceeds the token limit + +## 2.1.144 + +- Added `/resume` support for background sessions — sessions started via `claude --bg` or agent view now appear alongside interactive ones, marked with `bg` +- Added elapsed duration to background subagent completion notifications (e.g. "Agent completed · 3h 2m 5s") +- The `/plugin` browse and discover panes now show when a plugin was last updated +- `/model` now changes the model for the current session only; press `d` in the model picker to set a default for new sessions +- Renamed "extra usage" to "usage credits" across CLI copy; `/extra-usage` is now `/usage-credits` (old name still works) +- Fixed startup hanging up to 75s when `api.anthropic.com` is unreachable (captive portal, firewall, VPN issues) — side-channel API calls now time out after 15s +- Fixed garbled terminal output after a missed window-resize event (e.g. dragging a VS Code split-pane divider) — now self-heals on the next frame instead of requiring Ctrl+L +- Fixed progressive terminal display corruption (stale/garbled glyphs) that could appear in very long sessions and only cleared on terminal resize or restart +- Reduced terminal rendering glitches in VS Code by reducing spinner animation color count +- Fixed macOS background sessions crashing with "exit 1 before init" when the project lives under a Full Disk Access-protected folder (regression in 2.1.143) +- Fixed an unrecoverable conversation when reading a file whose image extension doesn't match its contents (e.g. HTML saved as .png) — now falls back to text +- Fewer spurious tool errors during search: `head`/`tail` file views now satisfy the read-before-edit check, and a "no matches" result (exit code 1) from `egrep`, `fgrep`, `git grep`, or `git diff` is no longer reported as a command failure +- Fixed `/branch` failing with "No conversation to branch" after entering a worktree or in some background sessions +- Fixed pressing Escape in the AskUserQuestion notes field aborting the turn instead of returning to answer selection +- Fixed model selection not applying when changed via the IDE model picker or `applyFlagSettings` after startup +- Resumed sessions now keep the model they were using instead of picking up another session's `/model` choice +- Fixed Bedrock and Vertex users unable to select "Opus (1M context)" from the `/model` picker (regression in v2.1.129) +- Fixed remote-session login failing with "Can't access this organization" for users with `forceLoginMethod` and `forceLoginOrgUUID` set +- Fixed MCP servers with paginated `tools/list` responses only returning the first page, silently dropping tools +- Fixed MCP images with unsupported MIME types (e.g. SVG) breaking the conversation — now saved to disk and referenced in the tool result +- Fixed file descriptor exhaustion when a build runs inside a skill directory — non-`.md` files no longer trigger skill reloads +- Fixed session title being generated from plugin monitor output instead of the user's first prompt +- Fixed Skill tool failing with permission error in headless mode (regression in v2.1.141) +- Fixed plugins enabled in your own settings showing "not cached" errors after first load on a fresh machine; plugins enabled only by a project's `.claude/settings.json` now show an actionable `claude plugin install` hint +- Fixed `claude mcp list` silently reporting no servers when `.mcp.json` can't be parsed (e.g. using VS Code's `"servers"` key instead of `"mcpServers"`) — now shows configuration errors +- Fixed background side-queries on custom `ANTHROPIC_BASE_URL` setups and Bedrock Mantle not using Haiku — now falls back correctly when a first-party API key is configured or no Haiku model is set +- Fixed scrolling in attached background sessions on Windows — PgUp/PgDn, mouse wheel, and Ctrl+O transcript navigation now work +- Fixed a crash when closing the terminal while attached to a background session +- Fixed on Windows, pressing ← in `claude agents` leaving the list unresponsive to keyboard input +- Fixed ghost characters at the left edge when switching panes in Agent View on Windows Terminal with CJK content +- `/bg` and `←`-detach now preserve directories added via `/add-dir` +- Fixed Edit/Write refusing with "background session hasn't isolated its changes yet" right after detaching a session that was already editing in place +- Fixed `claude respawn ` on a stopped background session showing "stopped" instead of running +- Fixed `/resume` picker not showing sessions forked from a background session +- Fixed opening a session from `claude agents` or running `claude logs ` hanging when the background service is unresponsive — now times out after 10s with a recovery hint +- Fixed background Bash tasks spawned by subagents staying "Running" in SDK task panels after the process exits +- Fixed completed or stopped background sessions briefly failing to wake being permanently marked as a startup crash +- Fixed markdown links in `claude agents` attached sessions rendering as plain text instead of clickable hyperlinks +- Fixed custom `spinnerVerbs` applying to the post-turn duration message — past-tense built-ins like "Worked for 5s" are restored there +- `claude agents` / `--bg` rejection messages now name the specific gate (non-TTY, env var, or setting) instead of a generic message +- `claude --bg --name