clud 2.0.3__py3-none-win_arm64.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
clud/__init__.py ADDED
@@ -0,0 +1,3 @@
1
+ """clud — Fast Rust CLI for running Claude Code and Codex in YOLO mode."""
2
+
3
+ __version__ = "2.0.3"
Binary file
Binary file
@@ -0,0 +1,186 @@
1
+ Metadata-Version: 2.4
2
+ Name: clud
3
+ Version: 2.0.3
4
+ Classifier: Development Status :: 4 - Beta
5
+ Classifier: Environment :: Console
6
+ Classifier: Intended Audience :: Developers
7
+ Classifier: License :: OSI Approved :: BSD License
8
+ Classifier: Operating System :: OS Independent
9
+ Classifier: Programming Language :: Rust
10
+ Classifier: Programming Language :: Python :: 3
11
+ Classifier: Topic :: Software Development :: Build Tools
12
+ License-File: LICENSE
13
+ Summary: Fast Rust CLI for running Claude Code and Codex in YOLO mode
14
+ Keywords: claude,codex,cli,ai,agent
15
+ Home-Page: https://github.com/zackees/clud
16
+ Author: Zach Vorhies
17
+ License: BSD 3-Clause License
18
+ Requires-Python: >=3.10
19
+ Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
20
+ Project-URL: Homepage, https://github.com/zackees/clud
21
+ Project-URL: Issues, https://github.com/zackees/clud/issues
22
+ Project-URL: Repository, https://github.com/zackees/clud
23
+
24
+ # clud
25
+
26
+ ![hero-clud](https://github.com/user-attachments/assets/4009dfee-e703-446d-b073-80d826708a10)
27
+
28
+ **A fast Rust CLI for Claude Code and Codex that runs in YOLO mode by default — no permission prompts, maximum velocity.**
29
+
30
+ The name `clud` is simply a shorter, easier-to-type version of `claude`.
31
+
32
+ | Platform | Build | Lint | Unit Test | Integration Test |
33
+ |----------|-------|------|-----------|------------------|
34
+ | Linux x86 | [![Build](https://github.com/zackees/clud/actions/workflows/linux-x86-build.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/linux-x86-build.yml) | [![Lint](https://github.com/zackees/clud/actions/workflows/linux-x86-lint.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/linux-x86-lint.yml) | [![Unit Test](https://github.com/zackees/clud/actions/workflows/linux-x86-unit-test.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/linux-x86-unit-test.yml) | [![Integration Test](https://github.com/zackees/clud/actions/workflows/linux-x86-integration-test.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/linux-x86-integration-test.yml) |
35
+ | Linux ARM | [![Build](https://github.com/zackees/clud/actions/workflows/linux-arm-build.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/linux-arm-build.yml) | [![Lint](https://github.com/zackees/clud/actions/workflows/linux-arm-lint.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/linux-arm-lint.yml) | [![Unit Test](https://github.com/zackees/clud/actions/workflows/linux-arm-unit-test.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/linux-arm-unit-test.yml) | [![Integration Test](https://github.com/zackees/clud/actions/workflows/linux-arm-integration-test.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/linux-arm-integration-test.yml) |
36
+ | Windows x86 | [![Build](https://github.com/zackees/clud/actions/workflows/windows-x86-build.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/windows-x86-build.yml) | [![Lint](https://github.com/zackees/clud/actions/workflows/windows-x86-lint.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/windows-x86-lint.yml) | [![Unit Test](https://github.com/zackees/clud/actions/workflows/windows-x86-unit-test.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/windows-x86-unit-test.yml) | [![Integration Test](https://github.com/zackees/clud/actions/workflows/windows-x86-integration-test.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/windows-x86-integration-test.yml) |
37
+ | Windows ARM | [![Build](https://github.com/zackees/clud/actions/workflows/windows-arm-build.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/windows-arm-build.yml) | [![Lint](https://github.com/zackees/clud/actions/workflows/windows-arm-lint.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/windows-arm-lint.yml) | [![Unit Test](https://github.com/zackees/clud/actions/workflows/windows-arm-unit-test.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/windows-arm-unit-test.yml) | [![Integration Test](https://github.com/zackees/clud/actions/workflows/windows-arm-integration-test.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/windows-arm-integration-test.yml) |
38
+ | macOS x86 | [![Build](https://github.com/zackees/clud/actions/workflows/macos-x86-build.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/macos-x86-build.yml) | [![Lint](https://github.com/zackees/clud/actions/workflows/macos-x86-lint.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/macos-x86-lint.yml) | [![Unit Test](https://github.com/zackees/clud/actions/workflows/macos-x86-unit-test.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/macos-x86-unit-test.yml) | [![Integration Test](https://github.com/zackees/clud/actions/workflows/macos-x86-integration-test.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/macos-x86-integration-test.yml) |
39
+ | macOS ARM | [![Build](https://github.com/zackees/clud/actions/workflows/macos-arm-build.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/macos-arm-build.yml) | [![Lint](https://github.com/zackees/clud/actions/workflows/macos-arm-lint.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/macos-arm-lint.yml) | [![Unit Test](https://github.com/zackees/clud/actions/workflows/macos-arm-unit-test.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/macos-arm-unit-test.yml) | [![Integration Test](https://github.com/zackees/clud/actions/workflows/macos-arm-integration-test.yml/badge.svg)](https://github.com/zackees/clud/actions/workflows/macos-arm-integration-test.yml) |
40
+
41
+ ## Installation
42
+
43
+ ```bash
44
+ pip install clud
45
+ ```
46
+
47
+ ## Usage
48
+
49
+ ```bash
50
+ clud # Launch Claude in YOLO mode via subprocess
51
+ clud --codex # Use Codex as the backend
52
+ clud --claude # Use Claude as the backend (default)
53
+ clud --pty # Force PTY launch mode
54
+ clud --subprocess # Force subprocess launch mode
55
+ clud -c # Continue the most recent conversation
56
+ clud --resume # Resume a session
57
+ clud --resume abc123 # Resume a specific session by ID or search term
58
+ clud -p "refactor the auth layer" # Run with a prompt, exit when done
59
+ clud -m "what does this do?" # Send a one-off message
60
+ clud --model opus -p "review PR" # Choose a model
61
+ clud --safe -p "drop the table" # Disable YOLO mode (keeps permission prompts)
62
+ clud --dry-run -p "hello" # Print what would run without executing
63
+ echo "explain this error" | clud # Pipe mode: read prompt from stdin
64
+ clud -- --verbose --debug # Pass extra flags through to the backend
65
+ clud wasm guest.wasm # Run a local wasm module with clud's embedded runtime
66
+ ```
67
+
68
+ ### Flags
69
+
70
+ | Flag | Description |
71
+ |------|-------------|
72
+ | `-p`, `--prompt` | Run with a prompt, exit when complete |
73
+ | `-m`, `--message` | Send a one-off message |
74
+ | `-c`, `--continue` | Continue the most recent conversation |
75
+ | `-r`, `--resume [TERM]` | Resume by session ID or search term |
76
+ | `--claude` | Use Claude as the backend |
77
+ | `--codex` | Use Codex as the backend |
78
+ | `--subprocess` | Force subprocess launch mode |
79
+ | `--pty` | Force PTY launch mode |
80
+ | `--model <NAME>` | Set model preference (e.g., haiku, sonnet, opus) |
81
+ | `--safe` | Disable YOLO mode (don't inject `--dangerously-skip-permissions`) |
82
+ | `--dry-run` | Print what would be executed, then exit |
83
+ | `-v`, `--verbose` | Show debug output |
84
+ | `-h`, `--help` | Show help |
85
+ | `-V`, `--version` | Show version |
86
+
87
+ Unknown flags are forwarded directly to the backend agent.
88
+
89
+ `clud` now defaults to subprocess launch mode for Claude and Codex. Use `--pty`
90
+ to opt back into PTY while Claude PTY issues are being investigated.
91
+
92
+ ## Voice Mode
93
+
94
+ `clud` can capture microphone input and transcribe it into the active console prompt with
95
+ `whisper-rs`.
96
+
97
+ ```bash
98
+ # English-only small model
99
+ export CLUD_VOICE=1
100
+ export CLUD_WHISPER_MODEL=/path/to/ggml-small.en.bin
101
+
102
+ clud
103
+ ```
104
+
105
+ On Windows PowerShell:
106
+
107
+ ```powershell
108
+ $env:CLUD_VOICE = "1"
109
+ $env:CLUD_WHISPER_MODEL = "C:\models\ggml-small.en.bin"
110
+
111
+ clud
112
+ ```
113
+
114
+ Behavior:
115
+
116
+ - Press `F3` to start recording and play a short `ding`
117
+ - Release `F3` to stop recording and play a short `dong`
118
+ - The transcript is inserted into the current prompt without auto-submitting it
119
+ - If the terminal does not emit key-release events, pressing `F3` again stops recording
120
+
121
+ Optional environment variables:
122
+
123
+ | Variable | Description |
124
+ |----------|-------------|
125
+ | `CLUD_VOICE` | Enable voice mode (`1`, `true`, `yes`, `on`) |
126
+ | `CLUD_WHISPER_MODEL` | Path to a local `whisper.cpp` GGML model such as `ggml-small.en.bin` |
127
+ | `CLUD_VOICE_LANGUAGE` | Force a Whisper language code such as `en` |
128
+
129
+ ## `clud loop` — Autonomous Loop
130
+
131
+ Run the backend in an autonomous loop that iterates on a task (default: 50 iterations).
132
+
133
+ ```bash
134
+ clud loop "Implement the API endpoints from the spec"
135
+ clud loop TASK.md # Read prompt from a file
136
+ clud loop --loop-count 10 "fix bugs" # Custom iteration count
137
+ ```
138
+
139
+ The loop stops early if any iteration exits with a non-zero code.
140
+
141
+ ## `clud rebase` — Auto-Rebase
142
+
143
+ Fetches from origin, rebases the current branch, and resolves conflicts.
144
+
145
+ ```bash
146
+ clud rebase
147
+ ```
148
+
149
+ ## `clud fix` — Auto-Fix
150
+
151
+ Detects linting and test tools in your repo, runs them, and fixes failures in a loop until everything passes.
152
+
153
+ ```bash
154
+ clud fix
155
+ ```
156
+
157
+ ## `clud up` — Ship It
158
+
159
+ Runs lint, test, cleanup, then commits.
160
+
161
+ ```bash
162
+ clud up
163
+ ```
164
+
165
+ ## `clud wasm` — Embedded Runtime
166
+
167
+ Loads a local `.wasm` module, wires up a host logging import, and invokes an exported function.
168
+
169
+ ```bash
170
+ clud wasm hello.wasm
171
+ clud wasm hello.wasm --invoke _start
172
+ ```
173
+
174
+ ## Development
175
+
176
+ ```bash
177
+ bash build # Build dev wheel (Rust binary + Python package)
178
+ bash lint # Lint (cargo fmt + clippy + ruff + banned imports)
179
+ bash test # Unit tests (Rust + Python)
180
+ bash test --integration # Include integration tests with mock agents
181
+ ```
182
+
183
+ ## License
184
+
185
+ BSD 3-Clause License
186
+
@@ -0,0 +1,10 @@
1
+ clud/__init__.py,sha256=OQh6mxFJlRXWI9EId2RQNdgJET_K5xhCpF76YbKKXIc,103
2
+ clud-2.0.3.data/scripts/clud.exe,sha256=kXwaRD92-fcrAsLjcIqKyybBFOWTQ4q7pzeUL5U4qnQ,2894848
3
+ clud-2.0.3.data/scripts/libgcc_s_seh-1.dll,sha256=FiCNVd1HYC6ovCfXUvqmavvsuiIA40auC0HJqU--Ow4,143872
4
+ clud-2.0.3.data/scripts/libstdc++-6.dll,sha256=6iUid8WTnNY4SKPbRlz3yI5I2-Fp7f1PGdNFhRprQAw,2302464
5
+ clud-2.0.3.data/scripts/libwinpthread-1.dll,sha256=9QQujj0h7c4gwbyZRF9VG4khJAMWTpOI0sb0jW1ry3g,55808
6
+ clud-2.0.3.dist-info/licenses/LICENSE,sha256=ABNQ2d5frOz6joFVwOH-JY3aPSX74pJooGE7nwBkqco,1527
7
+ clud-2.0.3.dist-info/METADATA,sha256=RjSHMghP8L1m-Iy5uvk6VlLAKJuuISkXa-txcbbRAwM,10304
8
+ clud-2.0.3.dist-info/sboms/clud.cyclonedx.json,sha256=L2rFbLvNm5fKcvqtiNwNEOabI5BbTAMf_TEC3wzkLrU,122593
9
+ clud-2.0.3.dist-info/WHEEL,sha256=agSxb0CzzJpPcHA6HtV6Hyu3P0WI4f1HePFlvTVm6SM,94
10
+ clud-2.0.3.dist-info/RECORD,,
@@ -0,0 +1,4 @@
1
+ Wheel-Version: 1.0
2
+ Generator: maturin (1.13.1)
3
+ Root-Is-Purelib: false
4
+ Tag: py3-none-win_arm64
@@ -0,0 +1,28 @@
1
+ BSD 3-Clause License
2
+
3
+ Copyright (c) 2024, Zach Vorhies
4
+
5
+ Redistribution and use in source and binary forms, with or without
6
+ modification, are permitted provided that the following conditions are met:
7
+
8
+ 1. Redistributions of source code must retain the above copyright notice, this
9
+ list of conditions and the following disclaimer.
10
+
11
+ 2. Redistributions in binary form must reproduce the above copyright notice,
12
+ this list of conditions and the following disclaimer in the documentation
13
+ and/or other materials provided with the distribution.
14
+
15
+ 3. Neither the name of the copyright holder nor the names of its
16
+ contributors may be used to endorse or promote products derived from
17
+ this software without specific prior written permission.
18
+
19
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
20
+ AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
22
+ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
23
+ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
25
+ SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
26
+ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
27
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
28
+ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.