claude-yolo-extended 1.9.2 → 1.9.5
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.
- package/.claude/commands/shutdown.md +17 -17
- package/.claude/commands/startup.md +13 -13
- package/.editorconfig +21 -0
- package/.github/workflows/publish.yml +34 -0
- package/.prettierrc +8 -0
- package/AI_HANDOFF.md +17 -15
- package/CLAUDE.md +83 -83
- package/CONTRIBUTING.md +84 -0
- package/README.md +243 -243
- package/SECURITY.md +36 -0
- package/bin/ascii-art.js +58 -65
- package/bin/cl +116 -116
- package/bin/cl.js +174 -137
- package/bin/cl.ps1 +36 -36
- package/bin/claude-yolo.js +678 -388
- package/eslint.config.js +25 -0
- package/jest.config.js +9 -0
- package/lib/constants.js +97 -0
- package/package.json +57 -41
- package/postinstall.js +45 -51
- package/preuninstall.js +77 -0
- package/tests/constants.test.js +146 -0
|
@@ -1,18 +1,18 @@
|
|
|
1
|
-
You are initiating the "Project Shutdown Protocol." Please execute the following steps sequentially:
|
|
2
|
-
|
|
3
|
-
1. **Update Handoff Documentation**
|
|
4
|
-
- Open (or create) `AI_HANDOFF.md`.
|
|
5
|
-
- Update the "Current State" section to reflect what we accomplished today.
|
|
6
|
-
- **CRITICAL:** Clear the old "Next Steps" and write a new, granular list of instructions for the *next* session. Include any known bugs or unfinished logic.
|
|
7
|
-
|
|
8
|
-
2. **Code Quality Check**
|
|
9
|
-
- Briefly review the files we modified today. Ensure there are no leftover debug print statements or commented-out blocks that shouldn't be there.
|
|
10
|
-
|
|
11
|
-
3. **Git Operations**
|
|
12
|
-
- Run `git add .`
|
|
13
|
-
- Generate a concise but descriptive commit message based on the work done.
|
|
14
|
-
- Run `git commit -m "your_message"`
|
|
15
|
-
- Run `git push`
|
|
16
|
-
|
|
17
|
-
4. **Final Status**
|
|
1
|
+
You are initiating the "Project Shutdown Protocol." Please execute the following steps sequentially:
|
|
2
|
+
|
|
3
|
+
1. **Update Handoff Documentation**
|
|
4
|
+
- Open (or create) `AI_HANDOFF.md`.
|
|
5
|
+
- Update the "Current State" section to reflect what we accomplished today.
|
|
6
|
+
- **CRITICAL:** Clear the old "Next Steps" and write a new, granular list of instructions for the *next* session. Include any known bugs or unfinished logic.
|
|
7
|
+
|
|
8
|
+
2. **Code Quality Check**
|
|
9
|
+
- Briefly review the files we modified today. Ensure there are no leftover debug print statements or commented-out blocks that shouldn't be there.
|
|
10
|
+
|
|
11
|
+
3. **Git Operations**
|
|
12
|
+
- Run `git add .`
|
|
13
|
+
- Generate a concise but descriptive commit message based on the work done.
|
|
14
|
+
- Run `git commit -m "your_message"`
|
|
15
|
+
- Run `git push`
|
|
16
|
+
|
|
17
|
+
4. **Final Status**
|
|
18
18
|
- Confirm when the push is successful and the handoff file is saved.
|
|
@@ -1,14 +1,14 @@
|
|
|
1
|
-
You are initiating the "Project Startup Protocol." Please execute the following steps sequentially:
|
|
2
|
-
|
|
3
|
-
1. **Git Synchronization**
|
|
4
|
-
- Run `git status` to ensure the directory is clean.
|
|
5
|
-
- If clean, run `git pull` to ensure we have the latest remote changes.
|
|
6
|
-
|
|
7
|
-
2. **Context Retrieval**
|
|
8
|
-
- Check for a file named `AI_HANDOFF.md` in the root directory.
|
|
9
|
-
- **If found:** Read it to understand the current project state and the "Next Steps" defined in the previous session.
|
|
10
|
-
- **If NOT found:** Scan the `README.md` and the last 3 git commit messages to orient yourself, then create a new `AI_HANDOFF.md` file using the current context.
|
|
11
|
-
|
|
12
|
-
3. **Plan Formulation**
|
|
13
|
-
- Based specifically on the "Next Steps" from the handoff file, outline the plan for this session.
|
|
1
|
+
You are initiating the "Project Startup Protocol." Please execute the following steps sequentially:
|
|
2
|
+
|
|
3
|
+
1. **Git Synchronization**
|
|
4
|
+
- Run `git status` to ensure the directory is clean.
|
|
5
|
+
- If clean, run `git pull` to ensure we have the latest remote changes.
|
|
6
|
+
|
|
7
|
+
2. **Context Retrieval**
|
|
8
|
+
- Check for a file named `AI_HANDOFF.md` in the root directory.
|
|
9
|
+
- **If found:** Read it to understand the current project state and the "Next Steps" defined in the previous session.
|
|
10
|
+
- **If NOT found:** Scan the `README.md` and the last 3 git commit messages to orient yourself, then create a new `AI_HANDOFF.md` file using the current context.
|
|
11
|
+
|
|
12
|
+
3. **Plan Formulation**
|
|
13
|
+
- Based specifically on the "Next Steps" from the handoff file, outline the plan for this session.
|
|
14
14
|
- Do not write code yet. Present the plan and wait for my approval.
|
package/.editorconfig
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# EditorConfig helps maintain consistent coding styles
|
|
2
|
+
# https://editorconfig.org
|
|
3
|
+
|
|
4
|
+
root = true
|
|
5
|
+
|
|
6
|
+
[*]
|
|
7
|
+
charset = utf-8
|
|
8
|
+
end_of_line = lf
|
|
9
|
+
indent_style = space
|
|
10
|
+
indent_size = 2
|
|
11
|
+
insert_final_newline = true
|
|
12
|
+
trim_trailing_whitespace = true
|
|
13
|
+
|
|
14
|
+
[*.md]
|
|
15
|
+
trim_trailing_whitespace = false
|
|
16
|
+
|
|
17
|
+
[*.json]
|
|
18
|
+
indent_size = 2
|
|
19
|
+
|
|
20
|
+
[Makefile]
|
|
21
|
+
indent_style = tab
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
name: Publish to npm
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
tags:
|
|
6
|
+
- 'v*'
|
|
7
|
+
|
|
8
|
+
jobs:
|
|
9
|
+
publish:
|
|
10
|
+
runs-on: ubuntu-latest
|
|
11
|
+
permissions:
|
|
12
|
+
contents: read
|
|
13
|
+
id-token: write
|
|
14
|
+
steps:
|
|
15
|
+
- name: Checkout
|
|
16
|
+
uses: actions/checkout@v4
|
|
17
|
+
|
|
18
|
+
- name: Setup Node.js
|
|
19
|
+
uses: actions/setup-node@v4
|
|
20
|
+
with:
|
|
21
|
+
node-version: '22'
|
|
22
|
+
registry-url: 'https://registry.npmjs.org'
|
|
23
|
+
|
|
24
|
+
- name: Update npm to latest
|
|
25
|
+
run: npm install -g npm@latest
|
|
26
|
+
|
|
27
|
+
- name: Verify npm version
|
|
28
|
+
run: npm --version
|
|
29
|
+
|
|
30
|
+
- name: Install dependencies
|
|
31
|
+
run: npm ci
|
|
32
|
+
|
|
33
|
+
- name: Publish to npm
|
|
34
|
+
run: npm publish --provenance --access public
|
package/.prettierrc
ADDED
package/AI_HANDOFF.md
CHANGED
|
@@ -1,15 +1,17 @@
|
|
|
1
|
-
# AI Session Handoff
|
|
2
|
-
|
|
3
|
-
## Current State
|
|
4
|
-
* **Last Updated:** 2025-12-26
|
|
5
|
-
* **Version:** 1.9.
|
|
6
|
-
* **Status:**
|
|
7
|
-
|
|
8
|
-
##
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
1
|
+
# AI Session Handoff
|
|
2
|
+
|
|
3
|
+
## Current State
|
|
4
|
+
* **Last Updated:** 2025-12-26
|
|
5
|
+
* **Version:** 1.9.4 (ready for 1.9.5)
|
|
6
|
+
* **Status:** All verification complete, ready to publish
|
|
7
|
+
|
|
8
|
+
## Verification Results
|
|
9
|
+
- npm install: 331 packages, 0 vulnerabilities
|
|
10
|
+
- npm test: 14/14 tests passed
|
|
11
|
+
- npm run lint: 0 errors
|
|
12
|
+
- npm run format: Applied to 4 files
|
|
13
|
+
|
|
14
|
+
## NEXT STEPS (Resume Work Here)
|
|
15
|
+
1. [ ] Run `npm version patch` to bump to 1.9.5
|
|
16
|
+
2. [ ] Run `git push origin main --tags` to push changes
|
|
17
|
+
3. [ ] Delete CODE_REVIEW_TASKS.md after successful publish
|
package/CLAUDE.md
CHANGED
|
@@ -1,83 +1,83 @@
|
|
|
1
|
-
# Claude YOLO Extended - Project Information
|
|
2
|
-
|
|
3
|
-
This document contains important information about the Claude YOLO Extended project for AI assistants.
|
|
4
|
-
|
|
5
|
-
## Project Overview
|
|
6
|
-
|
|
7
|
-
Claude YOLO Extended is a wrapper for the Claude CLI that provides:
|
|
8
|
-
- **YOLO Mode**: Bypasses safety checks (use with caution)
|
|
9
|
-
- **SAFE Mode**: Standard Claude CLI behavior with all safety checks
|
|
10
|
-
- **Cross-Platform Support**: Works on Windows, Ubuntu, and other Unix systems
|
|
11
|
-
- **Auto-Update**: Automatically updates to the latest Claude CLI version
|
|
12
|
-
|
|
13
|
-
## Installation Methods
|
|
14
|
-
|
|
15
|
-
### From npm (Recommended for users)
|
|
16
|
-
```bash
|
|
17
|
-
npm install -g claude-yolo-extended
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
### From source (For development)
|
|
21
|
-
```bash
|
|
22
|
-
git clone https://github.com/jslitzkerttcu/claude-yolo.git
|
|
23
|
-
cd claude-yolo
|
|
24
|
-
npm install
|
|
25
|
-
npm link
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
## Key Commands
|
|
29
|
-
|
|
30
|
-
- `claude-yolo-extended` - Run in current mode (default: YOLO)
|
|
31
|
-
- `claude-yolo-extended --safe` - Run in SAFE mode
|
|
32
|
-
- `claude-yolo-extended mode yolo` - Switch to YOLO mode
|
|
33
|
-
- `claude-yolo-extended mode safe` - Switch to SAFE mode
|
|
34
|
-
- `cl /YON` - Enable YOLO mode and start Claude
|
|
35
|
-
- `cl /YOFF` - Enable SAFE mode and start Claude
|
|
36
|
-
|
|
37
|
-
## Development Workflow
|
|
38
|
-
|
|
39
|
-
### Making Changes
|
|
40
|
-
|
|
41
|
-
1. Make code changes
|
|
42
|
-
2. Test locally with `npm link`
|
|
43
|
-
3. Run `claude-yolo-extended --help` to verify
|
|
44
|
-
|
|
45
|
-
### Publishing Updates
|
|
46
|
-
|
|
47
|
-
1. Update version: `npm version patch|minor|major`
|
|
48
|
-
2. Publish: `npm publish`
|
|
49
|
-
3. Push to GitHub: `git push origin main --tags`
|
|
50
|
-
|
|
51
|
-
### Version Strategy
|
|
52
|
-
|
|
53
|
-
- **patch**: Bug fixes (1.8.0 -> 1.8.1)
|
|
54
|
-
- **minor**: New features (1.8.0 -> 1.9.0)
|
|
55
|
-
- **major**: Breaking changes (1.8.0 -> 2.0.0)
|
|
56
|
-
|
|
57
|
-
## Important Files
|
|
58
|
-
|
|
59
|
-
- `bin/claude-yolo.js` - Main wrapper script
|
|
60
|
-
- `bin/cl` - Bash convenience wrapper
|
|
61
|
-
- `bin/cl.ps1` - PowerShell convenience wrapper
|
|
62
|
-
- `package.json` - Project configuration
|
|
63
|
-
- `.npmignore` - Files excluded from npm package
|
|
64
|
-
|
|
65
|
-
## Security Considerations
|
|
66
|
-
|
|
67
|
-
- YOLO mode bypasses important safety checks
|
|
68
|
-
- The tool modifies Claude CLI behavior at runtime
|
|
69
|
-
- Consent is required on first run
|
|
70
|
-
- Mode preference is stored in `~/.claude_yolo_state`
|
|
71
|
-
|
|
72
|
-
## Project URLs
|
|
73
|
-
|
|
74
|
-
- **npm Package**: https://www.npmjs.com/package/claude-yolo-extended
|
|
75
|
-
- **GitHub Repository**: https://github.com/jslitzkerttcu/claude-yolo
|
|
76
|
-
- **Issues**: https://github.com/jslitzkerttcu/claude-yolo/issues
|
|
77
|
-
|
|
78
|
-
## AI_HANDOFF.md Protocol
|
|
79
|
-
(These rules govern the 'AI_HANDOFF.md' file found in the root)
|
|
80
|
-
1. **Transient State Only:** This file is a specific 'mutex' token for the next session. It is NOT a project history log.
|
|
81
|
-
2. **No Documentation:** Do not write architectural decisions or code snippets here. Use README.md for that.
|
|
82
|
-
3. **Clean Up:** When updating this file, REMOVE completed tasks. Do not mark them as [x] and leave them. The file should only ever contain the *current* state and *immediate* next steps.
|
|
83
|
-
4. **Size Limit:** Keep this file short (under 50 lines).
|
|
1
|
+
# Claude YOLO Extended - Project Information
|
|
2
|
+
|
|
3
|
+
This document contains important information about the Claude YOLO Extended project for AI assistants.
|
|
4
|
+
|
|
5
|
+
## Project Overview
|
|
6
|
+
|
|
7
|
+
Claude YOLO Extended is a wrapper for the Claude CLI that provides:
|
|
8
|
+
- **YOLO Mode**: Bypasses safety checks (use with caution)
|
|
9
|
+
- **SAFE Mode**: Standard Claude CLI behavior with all safety checks
|
|
10
|
+
- **Cross-Platform Support**: Works on Windows, Ubuntu, and other Unix systems
|
|
11
|
+
- **Auto-Update**: Automatically updates to the latest Claude CLI version
|
|
12
|
+
|
|
13
|
+
## Installation Methods
|
|
14
|
+
|
|
15
|
+
### From npm (Recommended for users)
|
|
16
|
+
```bash
|
|
17
|
+
npm install -g claude-yolo-extended
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
### From source (For development)
|
|
21
|
+
```bash
|
|
22
|
+
git clone https://github.com/jslitzkerttcu/claude-yolo.git
|
|
23
|
+
cd claude-yolo
|
|
24
|
+
npm install
|
|
25
|
+
npm link
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
## Key Commands
|
|
29
|
+
|
|
30
|
+
- `claude-yolo-extended` - Run in current mode (default: YOLO)
|
|
31
|
+
- `claude-yolo-extended --safe` - Run in SAFE mode
|
|
32
|
+
- `claude-yolo-extended mode yolo` - Switch to YOLO mode
|
|
33
|
+
- `claude-yolo-extended mode safe` - Switch to SAFE mode
|
|
34
|
+
- `cl /YON` - Enable YOLO mode and start Claude
|
|
35
|
+
- `cl /YOFF` - Enable SAFE mode and start Claude
|
|
36
|
+
|
|
37
|
+
## Development Workflow
|
|
38
|
+
|
|
39
|
+
### Making Changes
|
|
40
|
+
|
|
41
|
+
1. Make code changes
|
|
42
|
+
2. Test locally with `npm link`
|
|
43
|
+
3. Run `claude-yolo-extended --help` to verify
|
|
44
|
+
|
|
45
|
+
### Publishing Updates
|
|
46
|
+
|
|
47
|
+
1. Update version: `npm version patch|minor|major`
|
|
48
|
+
2. Publish: `npm publish`
|
|
49
|
+
3. Push to GitHub: `git push origin main --tags`
|
|
50
|
+
|
|
51
|
+
### Version Strategy
|
|
52
|
+
|
|
53
|
+
- **patch**: Bug fixes (1.8.0 -> 1.8.1)
|
|
54
|
+
- **minor**: New features (1.8.0 -> 1.9.0)
|
|
55
|
+
- **major**: Breaking changes (1.8.0 -> 2.0.0)
|
|
56
|
+
|
|
57
|
+
## Important Files
|
|
58
|
+
|
|
59
|
+
- `bin/claude-yolo.js` - Main wrapper script
|
|
60
|
+
- `bin/cl` - Bash convenience wrapper
|
|
61
|
+
- `bin/cl.ps1` - PowerShell convenience wrapper
|
|
62
|
+
- `package.json` - Project configuration
|
|
63
|
+
- `.npmignore` - Files excluded from npm package
|
|
64
|
+
|
|
65
|
+
## Security Considerations
|
|
66
|
+
|
|
67
|
+
- YOLO mode bypasses important safety checks
|
|
68
|
+
- The tool modifies Claude CLI behavior at runtime
|
|
69
|
+
- Consent is required on first run
|
|
70
|
+
- Mode preference is stored in `~/.claude_yolo_state`
|
|
71
|
+
|
|
72
|
+
## Project URLs
|
|
73
|
+
|
|
74
|
+
- **npm Package**: https://www.npmjs.com/package/claude-yolo-extended
|
|
75
|
+
- **GitHub Repository**: https://github.com/jslitzkerttcu/claude-yolo
|
|
76
|
+
- **Issues**: https://github.com/jslitzkerttcu/claude-yolo/issues
|
|
77
|
+
|
|
78
|
+
## AI_HANDOFF.md Protocol
|
|
79
|
+
(These rules govern the 'AI_HANDOFF.md' file found in the root)
|
|
80
|
+
1. **Transient State Only:** This file is a specific 'mutex' token for the next session. It is NOT a project history log.
|
|
81
|
+
2. **No Documentation:** Do not write architectural decisions or code snippets here. Use README.md for that.
|
|
82
|
+
3. **Clean Up:** When updating this file, REMOVE completed tasks. Do not mark them as [x] and leave them. The file should only ever contain the *current* state and *immediate* next steps.
|
|
83
|
+
4. **Size Limit:** Keep this file short (under 50 lines).
|
package/CONTRIBUTING.md
ADDED
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
# Contributing to Claude YOLO Extended
|
|
2
|
+
|
|
3
|
+
Thank you for your interest in contributing!
|
|
4
|
+
|
|
5
|
+
## Development Setup
|
|
6
|
+
|
|
7
|
+
1. Clone the repository:
|
|
8
|
+
```bash
|
|
9
|
+
git clone https://github.com/jslitzkerttcu/claude-yolo.git
|
|
10
|
+
cd claude-yolo
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
2. Install dependencies:
|
|
14
|
+
```bash
|
|
15
|
+
npm install
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
3. Link for local development:
|
|
19
|
+
```bash
|
|
20
|
+
npm link
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## Development Workflow
|
|
24
|
+
|
|
25
|
+
### Running the Tool
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
# Run in YOLO mode
|
|
29
|
+
claude-yolo-extended
|
|
30
|
+
|
|
31
|
+
# Run in SAFE mode
|
|
32
|
+
claude-yolo-extended --safe
|
|
33
|
+
|
|
34
|
+
# Switch modes
|
|
35
|
+
claude-yolo-extended mode yolo
|
|
36
|
+
claude-yolo-extended mode safe
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### Code Quality
|
|
40
|
+
|
|
41
|
+
Before submitting a PR, ensure:
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
# Run linting
|
|
45
|
+
npm run lint
|
|
46
|
+
|
|
47
|
+
# Run tests
|
|
48
|
+
npm test
|
|
49
|
+
|
|
50
|
+
# Check formatting
|
|
51
|
+
npm run format:check
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
### Commit Guidelines
|
|
55
|
+
|
|
56
|
+
- Use conventional commit messages
|
|
57
|
+
- Keep commits focused and atomic
|
|
58
|
+
- Reference issues when applicable
|
|
59
|
+
|
|
60
|
+
### Pull Request Process
|
|
61
|
+
|
|
62
|
+
1. Fork the repository
|
|
63
|
+
2. Create a feature branch
|
|
64
|
+
3. Make your changes
|
|
65
|
+
4. Run linting and tests
|
|
66
|
+
5. Submit a pull request
|
|
67
|
+
|
|
68
|
+
## Project Structure
|
|
69
|
+
|
|
70
|
+
```
|
|
71
|
+
claude-yolo/
|
|
72
|
+
├── bin/ # CLI entry points
|
|
73
|
+
│ ├── claude-yolo.js # Main wrapper
|
|
74
|
+
│ ├── cl.js # cl command wrapper
|
|
75
|
+
│ └── ascii-art.js # ASCII art and status displays
|
|
76
|
+
├── lib/ # Shared modules
|
|
77
|
+
│ └── constants.js # Shared constants and utilities
|
|
78
|
+
├── tests/ # Test files
|
|
79
|
+
└── package.json
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
## Questions?
|
|
83
|
+
|
|
84
|
+
Open an issue on GitHub if you have questions or suggestions.
|