191 commits

This branch

This branch

All branches

Author	SHA1	Message	Date
GitHub Actions	243703531b	chore: bump bundled CLI version to 2.0.58	2025-12-03 20:09:56 +00:00
github-actions[bot]	9809fb6b54	chore: release v0.1.11 (#383) ... This PR updates the version to 0.1.11 after publishing to PyPI. ## Changes - Updated version in `pyproject.toml` to 0.1.11 - Updated version in `src/claude_agent_sdk/_version.py` to 0.1.11 - Updated `CHANGELOG.md` with release notes ## Release Information - Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.11/ - Bundled CLI version: 2.0.57 - Install with: `pip install claude-agent-sdk==0.1.11` 🤖 Generated by GitHub Actions --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>	2025-12-03 11:42:09 -08:00
GitHub Actions	afa39dc1bf	chore: bump bundled CLI version to 2.0.57	2025-12-03 05:24:28 +00:00
GitHub Actions	2a53aba5b9	chore: bump bundled CLI version to 2.0.56	2025-12-02 01:35:15 +00:00
John Ott	6e1769f8fd	feat: bundle claude code CLI for linux arm64 (#373) ... Currently wheels with packaged claude-code CLI are only published for windows amd64, linux x86_64 and macos arm64. For version 0.1.10, we can see the following download files are available on pypi contain the following artifacts: https://pypi.org/project/claude-agent-sdk/0.1.10/#files - claude_agent_sdk-0.1.10.tar.gz - claude_agent_sdk-0.1.10-py3-none-win_amd64.whl - claude_agent_sdk-0.1.10-py3-none-manylinux_2_17_x86_64.whl - claude_agent_sdk-0.1.10-py3-none-macosx_11_0_arm64.whl The existing publishing code should support adding a new linux arm64 wheel builder, using the Github ARM runners: https://github.blog/changelog/2025-08-07-arm64-hosted-runners-for-public-repositories-are-now-generally-available/ Unfortunately, there's no `ubuntu-latest-arm` label similar to the one we use for the other builds, so I'm using the `ubuntu-24.04-arm` label.	2025-12-01 12:44:57 -08:00
Dalton Flanagan	a2f24a3101	fix: wait for first result before closing stdin if SDK MCP present (#380) ... Port SDK MCP fix from TypeScript to Python. Now, when SDK MCP servers or hooks are present, stream_input() waits for the first result message before closing stdin, allowing bidirectional control protocol communication to complete. Fixes repro in https://github.com/anthropics/claude-agent-sdk-python/issues/266. The `query()` design requires input streams to be held open by the user for SDK MCP bidirectional communication to work. This has confused a lot of folks, so we're moving towards a more explicit lifecycle design. In the meantime, this is the way we've addressed it with V1 APIs in https://github.com/anthropics/claude-agent-sdk-typescript. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-12-01 10:19:51 -08:00
Ashwin Bhat	49482e1dfd	fix: correct mypy type ignore error codes for MCP decorators (#379) ... Update type: ignore comments to use `untyped-decorator` instead of `misc` to match the actual mypy error codes reported in CI. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-12-01 08:40:58 -08:00
ollie-anthropic	f21f63e181	Create sandbox adapter interface for Python SDK (#363) ... Adds programmatic sandbox configuration to the Python SDK, matching the TypeScript SDK's approach. Changes: - Add SandboxSettings, SandboxNetworkConfig, SandboxIgnoreViolations types - Add sandbox field to ClaudeAgentOptions - Merge sandbox into --settings CLI flag in SubprocessCLITransport - Export sandbox types from package __init__.py - Add comprehensive tests for sandbox settings **Important:** Filesystem and network restrictions are configured via permission rules (Read/Edit/WebFetch), not via these sandbox settings. The sandbox settings control sandbox behavior (enabled, auto-allow, excluded commands, etc.). Example usage: ```python from claude_agent_sdk import query, SandboxSettings result = query( prompt='Build and test the project', options=ClaudeAgentOptions( sandbox={ 'enabled': True, 'autoAllowBashIfSandboxed': True, 'excludedCommands': ['docker'], 'network': { 'allowLocalBinding': True, 'allowUnixSockets': ['/var/run/docker.sock'] } } ) ) ``` Co-authored-by: Claude <noreply@anthropic.com>	2025-12-01 01:44:59 -08:00
GitHub Actions	d553184ef6	chore: bump bundled CLI version to 2.0.55	2025-11-27 00:01:24 +00:00
github-actions[bot]	e2f8d814ea	chore: release v0.1.10 (#369) ... This PR updates the version to 0.1.10 after publishing to PyPI. ## Changes - Updated version in `pyproject.toml` to 0.1.10 - Updated version in `src/claude_agent_sdk/_version.py` to 0.1.10 - Updated `CHANGELOG.md` with release notes ## Release Information - Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.10/ - Bundled CLI version: 2.0.53 - Install with: `pip install claude-agent-sdk==0.1.10` 🤖 Generated by GitHub Actions --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>	2025-11-25 12:58:54 -05:00
GitHub Actions	be915896af	chore: bump bundled CLI version to 2.0.53	2025-11-25 01:55:19 +00:00
GitHub Actions	d15f26da91	chore: bump bundled CLI version to 2.0.52	2025-11-24 23:32:15 +00:00
GitHub Actions	112f3aa959	chore: bump bundled CLI version to 2.0.51	2025-11-24 18:48:28 +00:00
Noah Zweben	493f49fad9	Added slack issue notifier for new opened issues (#356) ... Posts new issues to claude-agent-sdk-feedback. Can't use the default github slack bot as it's too noisy (all comments and issue updates such as comments, closing, etc...) --------- Co-authored-by: Ashwin Bhat <ashwin@anthropic.com>	2025-11-23 21:24:25 -08:00
Harutaka Kawamura	7a5b413159	Fix: Fix HookMatcher.timeout type to float (#357) ... According to https://www.schemastore.org/claude-code-settings.json, the `timeout` type is `number`, not `integer` Signed-off-by: harupy <17039389+harupy@users.noreply.github.com>	2025-11-23 18:22:12 -05:00
GitHub Actions	23183a2698	chore: bump bundled CLI version to 2.0.50	2025-11-21 23:16:27 +00:00
Michael Dworsky	41ceacd807	Use CLAUDE_CODE_STREAM_CLOSE_TIMEOUT (if present) to override initialize() timeout (#354)	2025-11-21 16:46:22 -05:00
github-actions[bot]	f446e3e42a	chore: release v0.1.9 (#353) ... This PR updates the version to 0.1.9 after publishing to PyPI. ## Changes - Updated version in `pyproject.toml` to 0.1.9 - Updated version in `src/claude_agent_sdk/_version.py` to 0.1.9 - Updated `CHANGELOG.md` with release notes ## Release Information - Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.9/ - Bundled CLI version: 2.0.49 - Install with: `pip install claude-agent-sdk==0.1.9` 🤖 Generated by GitHub Actions --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>	2025-11-21 12:51:05 -08:00
GitHub Actions	36c75374ec	chore: bump bundled CLI version to 2.0.49	2025-11-21 01:31:38 +00:00
shawnm-anthropic	b0fb5b082a	Add AssistantMessageError type (#352) ... This brings Python to parity with https://github.com/anthropics/claude-cli-internal/pull/10358.	2025-11-19 19:23:10 -05:00
GitHub Actions	ab83878f5a	chore: bump bundled CLI version to 2.0.47	2025-11-19 23:12:47 +00:00
GitHub Actions	179818235a	chore: bump bundled CLI version to 2.0.46	2025-11-19 22:56:34 +00:00
Dickson Tsai	84edd73041	feat: add timeout parameter to HookMatcher (#351) ... ## Summary - Adds optional `timeout` field to `HookMatcher` dataclass in `types.py` that allows users to specify a custom timeout (in seconds) for hooks - Propagates the timeout value through: - `client.py` and `_internal/client.py`: `_convert_hooks_to_internal()` method - `_internal/query.py`: hook config sent to CLI ## Test plan - [x] Verify hooks work without timeout specified (default behavior) - [x] Verify custom timeout is passed to CLI when specified in HookMatcher 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-11-19 13:50:33 -08:00
Ashwin Bhat	bf528a1221	refactor: source CLI version from code in publish workflow (#350) ... Remove the claude_code_version workflow input and instead read the CLI version directly from src/claude_agent_sdk/_cli_version.py. This allows the version to be managed separately and updated by automation. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-11-19 09:49:35 -08:00
github-actions[bot]	d5dc615bd4	chore: release v0.1.8 (#346) ... This PR updates the version to 0.1.8 after publishing to PyPI. ## Changes - Updated version in `pyproject.toml` to 0.1.8 - Updated version in `src/claude_agent_sdk/_version.py` to 0.1.8 - Updated bundled CLI version in `src/claude_agent_sdk/_cli_version.py` to 2.0.45 - Updated `CHANGELOG.md` with release notes ## Release Information - Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.8/ - Bundled CLI version: 2.0.45 - Install with: `pip install claude-agent-sdk==0.1.8` 🤖 Generated by GitHub Actions --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Ashwin Bhat <ashwin@anthropic.com>	2025-11-18 21:21:57 -08:00
Ashwin Bhat	bab98e717e	fix: install wheel package for retagging platform-specific wheels (#345) ... The build_wheel.py script uses `python -m wheel tags` to retag wheels with platform-specific tags, but `wheel` wasn't explicitly installed. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-11-18 21:05:18 -08:00
Ashwin Bhat	ddc37c7330	fix: disable artifact compression to prevent wheel corruption (#344) ... Wheels are already ZIP files - double compression via GitHub Actions artifacts can cause "Mis-matched data size" errors on PyPI upload. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-11-18 20:55:17 -08:00
Ashwin Bhat	58cfffc623	fix: use PowerShell installer for Windows CLI download (#343) ... The bash install script (install.sh) explicitly rejects Windows. Use the PowerShell installer (install.ps1) instead when running on Windows, matching the approach used in test.yml. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-11-18 20:47:26 -08:00
Ashwin Bhat	35dd5b4bcc	fix: remove emojis from build_wheel.py for Windows compatibility (#342) ... Windows console encoding (cp1252) doesn't support Unicode emoji characters, causing UnicodeEncodeError in CI. Replaced all emoji characters with plain text equivalents. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-11-18 17:59:48 -08:00
Ashwin Bhat	ce99e9d2eb	feat: bundle Claude Code CLI in pip package (#283) ... Bundle platform-specific Claude Code CLI binaries directly in the Python package, eliminating the need for separate CLI installation. ## Changes ### Build System - Created `scripts/download_cli.py` to fetch CLI during build - Created `scripts/build_wheel.py` for building platform-specific wheels - Created `scripts/update_cli_version.py` to track bundled CLI version - Updated `pyproject.toml` to properly bundle CLI without duplicate file warnings - Made twine check non-blocking (License-File warnings are false positives) ### Runtime - Modified `subprocess_cli.py` to check for bundled CLI first - Added `_cli_version.py` to track which CLI version is bundled - SDK automatically uses bundled CLI, falling back to system installation if not found - Users can still override with `cli_path` option ### Release Workflow - Updated GitHub workflow to build separate wheels per platform (macOS, Linux, Windows) - Workflow now accepts two inputs: - `version`: Package version to publish (e.g., `0.1.5`) - `claude_code_version`: CLI version to bundle (e.g., `2.0.0` or `latest`) - Workflow builds platform-specific wheels with bundled CLI - Creates release PR that updates: - `pyproject.toml` version - `src/claude_agent_sdk/_version.py` - `src/claude_agent_sdk/_cli_version.py` with bundled CLI version - `CHANGELOG.md` with auto-generated release notes ### Documentation - Updated README to reflect bundled CLI (removed Node.js requirement) - Added release workflow documentation - Added local wheel building instructions ## Benefits - **Zero external dependencies**: No need for Node.js or npm - **Easier installation**: Single `pip install` gets everything - **Version control**: Track exactly which CLI version is bundled - **Flexible releases**: Can release new package versions with updated CLI without code changes - **Better user experience**: Works out of the box with no setup Platform-specific wheels are automatically selected by pip during installation based on the user's OS and architecture. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-11-18 17:21:15 -08:00
github-actions[bot]	6f209075bc	chore: release v0.1.7 (#341) ... This PR updates the version to 0.1.7 after publishing to PyPI. ## Changes - Updated version in `pyproject.toml` - Updated version in `src/claude_agent_sdk/_version.py` - Updated `CHANGELOG.md` with release notes ## Release Information - Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.7/ - Install with: `pip install claude-agent-sdk==0.1.7` 🤖 Generated by GitHub Actions --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: inigo <bogini@users.noreply.github.com>	2025-11-18 11:13:45 -08:00
bogini	50d68409c6	feat: add structured output support (#340) ... Add structured output support to Python SDK. ## Usage ```python from claude_agent_sdk import query, ClaudeAgentOptions schema = { "type": "object", "properties": {"count": {"type": "number"}}, "required": ["count"] } async for msg in query( prompt="Count files in src/", options=ClaudeAgentOptions( output_format={"type": "json_schema", "schema": schema} ) ): if hasattr(msg, 'structured_output'): print(msg.structured_output) ``` ## Documentation https://docs.claude.com/en/docs/agent-sdk/structured-outputs ## Tests - Unit tests: `tests/test_integration.py::TestIntegration::test_structured_output` - E2E tests: `e2e-tests/test_structured_output.py` (4 tests)	2025-11-18 11:01:17 -08:00
Suzanne Wang	ff425b293d	Add fallback model handling for parity with TypeScript SDK (#317) ... Add support for automatic model fallback when primary model is overloaded. The Python SDK passes the fallback_model parameter to the Claude CLI, which handles the validation and fallback logic. Changes: - Add fallback_model parameter to ClaudeAgentOptions - Pass --fallback-model to CLI subprocess - Add test for fallback model command building The validation that fallback_model != model happens at the CLI layer, keeping the SDK implementation simple and focused on parameter passing. --------- Co-authored-by: Claude <noreply@anthropic.com>	2025-11-07 11:25:45 -08:00
Ashwin Bhat	5a4cc2f41a	feat: add support for Claude CLI at ~/.claude/local/claude (#302) ... Add ~/.claude/local/claude to the list of locations checked when finding the Claude CLI binary. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-31 08:52:17 -07:00
github-actions[bot]	c30ffbeb56	chore: release v0.1.6 (#301) ... This PR updates the version to 0.1.6 after publishing to PyPI. ## Changes - Updated version in `pyproject.toml` - Updated version in `src/claude_agent_sdk/_version.py` - Updated `CHANGELOG.md` with release notes ## Release Information - Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.6/ - Install with: `pip install claude-agent-sdk==0.1.6` 🤖 Generated by GitHub Actions --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Ashwin Bhat <ashwin@anthropic.com>	2025-10-30 22:40:51 -07:00
yokomotod	841f8c0614	fix: uses empty system prompt by default (#290) ... fix #289	2025-10-30 22:03:42 -07:00
Ashwin Bhat	5256af2dac	Update publish.yml (#300)	2025-10-30 17:05:10 -07:00
Ashwin Bhat	edad138cb0	Limit CI examples to Python 3.13 only (#299) ... Reduce CI job count by only running examples on Python 3.13 instead of all Python versions (3.10-3.13). This reduces the combinatorial explosion while still ensuring examples work on the latest Python version. Co-authored-by: Claude <noreply@anthropic.com>	2025-10-30 17:05:01 -07:00
Ashwin Bhat	ae800c5ec8	feat: add max_budget_usd option to Python SDK (#293) ... Add support for limiting API costs using the max_budget_usd option, mirroring the TypeScript SDK functionality. When the budget is exceeded, query execution stops and returns a result with subtype 'error_max_budget_usd'. - Add max_budget_usd field to ClaudeAgentOptions - Pass --max-budget-usd flag to Claude Code CLI - Add test coverage for budget limit behavior 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-30 16:45:35 -07:00
blois	7be296f12e	feat: add max_thinking_tokens option to ClaudeAgentOptions (#298) ... Add support for controlling the maximum number of tokens allocated to extended thinking blocks via the max_thinking_tokens parameter. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-30 15:14:42 -07:00
Ashwin Bhat	fd4e33d4b9	feat: add /generate-changelog slash command (#287) ... Move changelog generation prompt from publish.yml into a reusable slash command at .claude/commands/generate-changelog.md. Update workflow to call the command with version parameters. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-24 16:21:55 -07:00
github-actions[bot]	68eb68b740	chore: release v0.1.5 (#286) ... This PR updates the version to 0.1.5 after publishing to PyPI. ## Changes - Updated version in `pyproject.toml` - Updated version in `src/claude_agent_sdk/_version.py` - Updated `CHANGELOG.md` with release notes ## Release Information - Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.5/ - Install with: `pip install claude-agent-sdk==0.1.5` 🤖 Generated by GitHub Actions --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Claude <noreply@anthropic.com>	2025-10-24 16:04:33 -07:00
Ashwin Bhat	c5957634ac	feat: add plugin support to Python SDK (#285) ... Add SdkPluginConfig type and plugins field to ClaudeAgentOptions. Plugins can be loaded using the local type with a path to the plugin directory. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-24 15:29:01 -07:00
github-actions[bot]	5656aeadd6	chore: release v0.1.4 (#260) ... This PR updates the version to 0.1.4 after publishing to PyPI. ## Changes - Updated version in `pyproject.toml` - Updated version in `src/claude_agent_sdk/_version.py` - Updated `CHANGELOG.md` with release notes ## Release Information - Published to PyPI: https://pypi.org/project/claude-agent-sdk/0.1.4/ - Install with: `pip install claude-agent-sdk==0.1.4` 🤖 Generated by GitHub Actions --------- Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Ashwin Bhat <ashwin@anthropic.com>	2025-10-23 16:10:13 -07:00
Ashwin Bhat	9b8576158d	fix: fetch all git history including tags in publish workflow (#284) ... The changelog generation step was failing to get the previous release tag because the checkout action was doing a shallow clone. Adding fetch-depth: 0 ensures all tags are available for git describe. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-23 15:03:41 -07:00
KuaaMU	41e220cc2c	fix: handle Windows command line length limit for --agents option (#245) ... ## Summary Fixes #238 - Resolves "command line too long" error on Windows when using multiple subagents with long prompts. ## Problem On Windows, the command line length is limited to 8191 characters (cmd.exe). When using multiple subagents with long prompts, the `--agents` JSON argument can easily exceed this limit, causing the error: ``` 命令行太长。 (command line too long) Fatal error in message reader: Command failed with exit code 1 ``` ## Solution This PR implements automatic detection and handling of command line length limits: 1. **Platform-specific limits**: - Windows: 8000 characters (safe margin below 8191) - Other platforms: 100,000 characters 2. **Automatic fallback**: When the command line would exceed the limit: - Write agents JSON to a temporary file - Use Claude CLI's `@filepath` syntax to reference the file - Clean up temp files when transport is closed 3. **Zero breaking changes**: The fix is transparent to users - it automatically activates only when needed ## Changes - Add `platform` and `tempfile` imports - Add `_CMD_LENGTH_LIMIT` constant with platform-specific values - Track temporary files in `self._temp_files` list - Modify `_build_command()` to detect long command lines and use temp files - Clean up temp files in `close()` method ## Testing - ✅ All existing tests pass (122 tests) - ✅ Linting and type checking pass - ✅ Minimal changes - only 47 lines added/modified - ✅ Solution transparently handles the Windows command line limit ## Test plan - [x] Test on Windows with multiple subagents and long prompts - [x] Verify temp files are created and cleaned up properly - [x] Verify normal operation (short command lines) is unaffected - [x] Test cross-platform compatibility (limit only applies on Windows) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-23 10:16:47 -07:00
Ashwin Bhat	923d3d4620	feat: add CLAUDE_AGENT_SDK_SKIP_VERSION_CHECK env var (#257) ... Adds environment variable to allow skipping the Claude Code version check. Users can set CLAUDE_AGENT_SDK_SKIP_VERSION_CHECK to disable the check. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-15 14:17:04 -07:00
Arash Dabiri	f27c4ab4c7	feat: Added base64 image handling to sdk_mcp_server tool calling (#175) ... With this change claude_code_sdk tools can now also return base64 images, in addition to text, following the MCP standard. For example: ``` import base64 @tool("make_response", "prompt", {"foo": str}) def make_response(args): fake_bytes = b"someimagebytes" encoded_image = base64.b64encode(fake_bytes).decode("utf-8") return { "content": [ {"type": "text", "text": "Hello world!"}, { "type": "image", "mimeType": "image/jpeg", "data": encoded_image, }, ] } ``` The image will now be sent to Claude Code when calling the function, allowing it to react to it. --------- Co-authored-by: Ashwin Bhat <ashwin@anthropic.com>	2025-10-15 07:22:14 -07:00
Ashwin Bhat	f896cd6f7f	feat: add pre-push hook for lint checks (#254) ... Adds a committable pre-push hook that runs ruff checks before pushing, matching the CI lint workflow. Developers run ./scripts/initial-setup.sh to install the hook locally. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>	2025-10-14 09:26:49 -07:00
Chase Naples	aebcf9d6a4	feat: add cli_path support to ClaudeAgentOptions (#235) ... ## Summary Adds support for passing custom Claude Code CLI paths through `ClaudeAgentOptions`, allowing organizations with non-standard installation locations to specify the CLI path explicitly. ## Motivation As noted in #214, organizations may install Claude Code CLI (or wrapped versions) at custom locations and prefer to provide those paths instead of relying on the SDK's default search logic. The transport layer already supported `cli_path`, but it was never exposed through the public API. ## Changes 1. **types.py**: Added `cli_path: str | Path | None = None` parameter to `ClaudeAgentOptions` dataclass 2. **_internal/client.py**: Pass `cli_path` from `configured_options.cli_path` to `SubprocessCLITransport` 3. **client.py**: Pass `cli_path` from `options.cli_path` to `SubprocessCLITransport` ## Implementation Details The `SubprocessCLITransport` constructor already accepted a `cli_path` parameter (line 40 of subprocess_cli.py), but it was never passed from the client layers. This PR completes the wiring by: - Adding the option to the public `ClaudeAgentOptions` interface - Extracting and passing it through both client implementations (`InternalClient.process_query` and `ClaudeSDKClient.connect`) ## Usage Example ```python from claude_agent_sdk import query, ClaudeAgentOptions # Specify custom CLI path options = ClaudeAgentOptions( cli_path="/custom/path/to/claude" ) result = await query("Hello!", options=options) ``` ## Testing - No new tests added as this is a straightforward parameter pass-through - Existing tests should continue to work (default behavior unchanged) - CI will validate the changes don't break existing functionality Fixes #214 --------- Co-authored-by: Ashwin Bhat <ashwin@anthropic.com>	2025-10-12 23:19:53 -07:00