myclaude v8.8.43-beta.3

myclaude is a provider-first AI coding CLI. Its core job is simple: start fast, connect to an Anthropic-compatible API directly, and keep model routing, provider credentials, and session startup under your control without depending on the default Claude Code login path.

Core

• Provider-first startup instead of account-first startup
• Saved provider profiles with API URL, credential, and routing in one place
• Anthropic-compatible gateway support for direct API usage
• Native commands myclaude, mycode, and optional installed claude
• Release flow built around tracked dist/ artifacts and npm distribution

What This Release Achieves

• Compaction now strips heavyweight attachment bodies from the summarizer input so long sessions are much less likely to OOM during conversation compaction
• Compact cache-sharing now falls back earlier on large or heap-pressured sessions instead of duplicating risky high-memory work
• Session exit now prints an explicit myclaude --resume ... command so users can reliably continue the exact session they just left
• Cross-project resume hints and in-product continuation tips now consistently use myclaude branding instead of leaking claude commands
• Search-path hardening from the previous beta remains included, so ripgrep failures surface as real errors instead of collapsing into silent empty results

Install

Requirements:

• Node.js 18 or newer
• macOS or Linux shell environment

Install globally from npm:

npm install -g myclaude-code

Run it once with npx if you do not want a global install:

npx myclaude-code

This installs the non-conflicting npm commands:

myclaude
mycode

Then run the built-in installer once to configure the native launcher, including the claude command:

myclaude install --force

After that, you can launch with:

myclaude
mycode
claude

One-line install:

curl -fsSL https://unpkg.com/myclaude-code/install.sh | bash

Install a specific version:

curl -fsSL https://unpkg.com/myclaude-code@8.8.43-beta.3/install.sh | bash -s -- 8.8.43-beta.3

Quick Start

1. Run myclaude
2. Open the provider configuration flow
3. Create or select a saved provider profile
4. Enter the API URL plus API key or token
5. Choose the primary, Haiku, Sonnet, and Opus model slots
6. Start the session immediately with the active profile

This package is intended for users who want a simpler setup path and faster access to compatible third-party providers.

On macOS, myclaude now avoids Keychain by default and stores local credentials in ~/.claude/.credentials.json so startup does not trigger system Keychain prompts. If you explicitly want the old Keychain behavior back, launch with MYCLAUDE_USE_KEYCHAIN=1 myclaude.

Commands

Version check:

myclaude --version
mycode --version
# available after running: myclaude install --force
claude --version

Provider/config entry point:

myclaude provider

Anthropic account login/token commands:

myclaude auth login
myclaude setup-token

Inside the interactive CLI, use /provider to switch a saved provider profile in one step. Each profile carries its API base URL, API key or token, and the effective primary/Haiku/Sonnet/Opus slot routing together. myclaude auth login and myclaude setup-token are only for Anthropic account auth flows; they are not the provider-profile entrypoint.

/provider
/provider list
/provider current
/provider save-current kimi-main
/provider adopt-current kimi-main
/provider validate
/provider repair
/provider use gpt54-main
/provider use kimi-main
/provider clear

Use /mao for first-party Codex execution through the active myclaude provider profile. This path reuses your current API URL and credential directly and does not require a separate codex login, a separate global Codex install, or a parallel Codex config flow. /codex remains as a compatibility alias, but /mao is the preferred command surface.

/mao setup
/mao review --background
/mao adversarial-review --base main auth and retry handling
/mao rescue --write fix the provider override bug and verify it
/mao status
/mao result

Use /team to inspect real local agent-team state from ~/.claude/teams instead of getting a generic explanation.

/team
/team list
/team current
/team status myteam
/team show myteam

Typing agent teams at the start of a prompt now opens the same native /team flow instead of sending that phrase to the model as plain text.

Use /retro to run a multi-round repo retrospective and upgrade loop inspired by karpathy/autoresearch. It treats tisheng.md as the product control document, ranks upgrade slices, implements one coherent improvement, verifies it, and then decides whether to keep advancing. By default it instructs the agent to carry a run tag plus an untracked .claude/retro/results.tsv keep/discard ledger and .claude/retro/latest.md working note so each round leaves behind reusable product memory instead of pure chat history.

/retro
/retro provider control center stability
/retro onboarding and route validation

Companion commands:

/girl
/boy
/bigdaddy
/girl provider
/girl provider list
/girl provider inherit
/girl provider use <profile>

Each companion can either follow the current app provider or bind to a saved /provider profile independently.

Recommended saved profile patterns:

• gpt54-main: gpt-5.4 as the primary model, with Sonnet/Haiku/Opus inheriting from that same stable route
• gpt53-all: gpt-5.3-codex for the main thread, subagents, and helper requests
• kimi-main or glm-main: provider-native routing with that provider's API URL and token

Compatibility:

• If ~/.ccjk/config.toml or ~/.ufomiao/zcf/config.toml exists, myclaude can import those profiles and follow the external active-profile switch
• Changing the active myclaude provider profile also writes the current selection back to those compatible config files
• For proxy GPT routes, myclaude now stays on Anthropic-compatible /v1/messages by default. Only set MYCLAUDE_API_DIALECT=openai_responses when you explicitly want the Responses adapter for that gateway.

Current gateway note:

• On the verified ttqq.inping.com route, gpt-5.4 is stable for the main thread
• gpt-5.1 is the current stable fallback for subagent and fast-helper slots
• gpt-5.3-codex may work intermittently, but this gateway sometimes returns upstream unauthorized errors for it

Release Model

• Source repo: https://github.com/mycode699/myclaude-code
• Public package: https://www.npmjs.com/package/myclaude-code
• Public install entrypoint: npx myclaude-code
• src/ is the development surface for new changes, while the checked-in dist/ bundle is the current release-authoritative artifact validated in CI
• GitHub Releases publish installable archives plus install.sh
• npm distributes the same tracked runtime bundle that powers dist/cli.js
• npm run rebuild:experimental and node scripts/build-plugin.mjs are reconstruction experiments only; they must not be used as release gates
• Trusted publishing is the intended npm release path so new tags do not require repeated local OTP prompts

Goals

• Remove startup dependence on Claude Code account login for normal provider-based use
• Make provider configuration feel native, direct, and routing-aware
• Keep installation simple through npm, npx, and the native installer
• Ship a reproducible release surface with verification around the checked-in runtime bundle
• Support real third-party gateways without hiding routing or credential state behind opaque defaults

Developer Verification

npm run validate:repo
npm run verify:dist
npm test
npm run check
npm run build
npm run package:release

• npm run validate:repo: checks package metadata, required tracked files, workflow presence, and tag/version consistency
• npm run verify:dist: smoke-tests dist/cli.js and dist/provider-setup.js
• npm test: runs packaging and release regression tests with Node's built-in test runner
• npm run check: full local verification gate used by CI
• npm run build: runs check and previews the publishable npm tarball with npm pack --dry-run
• npm run package:release: runs check and produces archives in release-artifacts/
• npm run rebuild:experimental: plugin-based experimental source rebuild that writes split output to experimental-dist/ and smoke-tests the wrapper entrypoint
• npm run rebuild:experimental:legacy: older reconstruction path kept for manual investigation

For source reconstruction experiments there is still npm run rebuild:experimental, and the older npm run rebuild:experimental:legacy path remains available for comparison. Both write only to generated paths and are intentionally not part of CI or release gating.

Package Focus

This repository is the release home for myclaude: install it quickly, configure a provider profile once, route the right models to the right roles, and start coding without the normal account-login friction.