claude-jacked 0.2.7__py3-none-any.whl → 0.3.0__py3-none-any.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.
@@ -0,0 +1,667 @@
1
+ Metadata-Version: 2.4
2
+ Name: claude-jacked
3
+ Version: 0.3.0
4
+ Summary: Smart reviewers, commands, and session search for Claude Code
5
+ Project-URL: Homepage, https://github.com/jackneil/claude-jacked
6
+ Project-URL: Repository, https://github.com/jackneil/claude-jacked
7
+ Project-URL: Issues, https://github.com/jackneil/claude-jacked/issues
8
+ Author-email: Jack Neil <jack@jackmd.com>
9
+ License-Expression: MIT
10
+ License-File: LICENSE
11
+ Keywords: ai,claude,context,qdrant,semantic-search
12
+ Classifier: Development Status :: 4 - Beta
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: License :: OSI Approved :: MIT License
15
+ Classifier: Programming Language :: Python :: 3
16
+ Classifier: Programming Language :: Python :: 3.10
17
+ Classifier: Programming Language :: Python :: 3.11
18
+ Classifier: Programming Language :: Python :: 3.12
19
+ Requires-Python: >=3.10
20
+ Requires-Dist: click>=8.0.0
21
+ Requires-Dist: python-dotenv>=1.0.0
22
+ Requires-Dist: rich>=13.0.0
23
+ Provides-Extra: all
24
+ Requires-Dist: anthropic>=0.40.0; extra == 'all'
25
+ Requires-Dist: qdrant-client>=1.7.0; extra == 'all'
26
+ Provides-Extra: dev
27
+ Requires-Dist: anthropic>=0.40.0; extra == 'dev'
28
+ Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
29
+ Requires-Dist: pytest>=7.0.0; extra == 'dev'
30
+ Requires-Dist: qdrant-client>=1.7.0; extra == 'dev'
31
+ Provides-Extra: search
32
+ Requires-Dist: qdrant-client>=1.7.0; extra == 'search'
33
+ Provides-Extra: security
34
+ Requires-Dist: anthropic>=0.40.0; extra == 'security'
35
+ Description-Content-Type: text/markdown
36
+
37
+ # claude-jacked
38
+
39
+ **Smart reviewers, quick commands, and session search for Claude Code.** Catch bugs before they ship, search past conversations, and auto-approve safe commands — all from within Claude Code.
40
+
41
+ ---
42
+
43
+ ## What You Get
44
+
45
+ - **Catch mistakes before they ship** — Built-in reviewers check for security issues, complexity, and common bugs.
46
+ - **Quick commands** — `/dc`, `/pr`, `/learn`, `/redo`, `/techdebt`, `/audit-rules` for common workflows.
47
+ - **Find past solutions instantly** — Search past Claude sessions by meaning, not keywords. *(requires [search] extra)*
48
+ - **Work from any computer** — Start on your desktop, continue on your laptop. *(requires [search] extra)*
49
+ - **Auto-approve safe commands** — Security gatekeeper evaluates bash commands so you only get interrupted for risky ones. *(requires [security] extra)*
50
+ - **Sound notifications** — Get audio alerts when Claude needs your attention or finishes a task.
51
+
52
+ ---
53
+
54
+ ## Table of Contents
55
+
56
+ - [Quick Start](#quick-start)
57
+ - [What's Included](#whats-included)
58
+ - [Using the Session Search](#using-the-session-search)
59
+ - [Working with Your Team](#working-with-your-team)
60
+ - [Built-in Reviewers and Commands](#built-in-reviewers-and-commands)
61
+ - [Security Gatekeeper](#security-gatekeeper)
62
+ - [Sound Notifications](#sound-notifications)
63
+ - [Uninstall](#uninstall)
64
+ - [Common Issues](#common-issues)
65
+ - [Advanced / Technical Reference](#advanced--technical-reference)
66
+
67
+ ---
68
+
69
+ ## Quick Start
70
+
71
+ ### Option 1: Let Claude Install It
72
+
73
+ Copy this into Claude Code and it will walk you through the options:
74
+
75
+ ```
76
+ Install claude-jacked for me. Use AskUserQuestion to ask me which features I want:
77
+
78
+ 1. First check if pipx and jacked are already installed
79
+ 2. Ask me which install tier I want:
80
+ - BASE: Smart reviewers, commands (/dc, /pr, /learn, etc.), behavioral rules
81
+ - SEARCH: Everything above + session search across machines (requires Qdrant Cloud ~$30/mo)
82
+ - SECURITY: Everything above + auto-approve safe bash commands (fewer permission prompts)
83
+ - ALL: Everything
84
+ 3. Install based on my choice:
85
+ - BASE: pipx install claude-jacked && jacked install
86
+ - SEARCH: pipx install "claude-jacked[search]" && jacked install
87
+ - SECURITY: pipx install "claude-jacked[security]" && jacked install --security
88
+ - ALL: pipx install "claude-jacked[all]" && jacked install --security
89
+ 4. If I chose SEARCH or ALL, help me set up Qdrant Cloud credentials
90
+ 5. Verify with: jacked --help
91
+ ```
92
+
93
+ ### Option 2: Manual Install
94
+
95
+ **Core (reviewers, commands, behavioral rules):**
96
+ ```bash
97
+ pipx install claude-jacked
98
+ jacked install
99
+ ```
100
+
101
+ **Add session search (optional):**
102
+ ```bash
103
+ pipx install "claude-jacked[search]"
104
+ jacked install
105
+ # Then set up Qdrant Cloud credentials (see below)
106
+ ```
107
+
108
+ **Add security gatekeeper (optional):**
109
+ ```bash
110
+ pipx install "claude-jacked[security]"
111
+ jacked install --security
112
+ ```
113
+
114
+ **Everything:**
115
+ ```bash
116
+ pipx install "claude-jacked[all]"
117
+ jacked install --security
118
+ ```
119
+
120
+ ---
121
+
122
+ ## What's Included
123
+
124
+ ### Base (`pip install claude-jacked`)
125
+
126
+ | Feature | What It Does |
127
+ |---------|--------------|
128
+ | **10 Smart Reviewers** | AI assistants that check your code for bugs, security issues, and complexity |
129
+ | **Quick Commands** | `/dc`, `/pr`, `/learn`, `/redo`, `/techdebt`, `/audit-rules` |
130
+ | **Behavioral Rules** | Auto-triggers for jacked commands, lesson tracking, plan-first workflow |
131
+ | **Sound Notifications** | Audio alerts when Claude needs input or finishes (via `--sounds`) |
132
+
133
+ ### Search Extra (`pip install "claude-jacked[search]"`)
134
+
135
+ | Feature | What It Does |
136
+ |---------|--------------|
137
+ | **Session Search** | Find any past Claude conversation by describing what you were working on |
138
+ | **Cross-Machine Sync** | Start on desktop, continue on laptop — your history follows you |
139
+ | **Team Sharing** | Search your teammates' sessions (with their permission) |
140
+
141
+ ### Security Extra (`pip install "claude-jacked[security]"`)
142
+
143
+ | Feature | What It Does |
144
+ |---------|--------------|
145
+ | **Security Gatekeeper** | Auto-approves safe bash commands, blocks dangerous ones, asks you about ambiguous ones |
146
+
147
+ ---
148
+
149
+ ## Using the Session Search
150
+
151
+ Once installed, you can search your past Claude sessions right from within Claude Code.
152
+
153
+ ### Example: Finding Past Work
154
+
155
+ You're working on user authentication and remember solving something similar before:
156
+
157
+ ```
158
+ /jacked user authentication login
159
+ ```
160
+
161
+ Claude will show you matching sessions:
162
+
163
+ ```
164
+ Search Results:
165
+ # Score User Age Repo Preview
166
+ 1 92% YOU 3d ago my-app Implementing JWT auth with refresh tokens...
167
+ 2 85% YOU 2w ago api-server Adding password reset flow...
168
+ 3 78% @sam 1w ago shared-lib OAuth2 integration with Google...
169
+ ```
170
+
171
+ Pick one to load that context into your current session.
172
+
173
+ ### Example: Resuming Work from Another Computer
174
+
175
+ You started building a feature on your desktop. Now you're on your laptop:
176
+
177
+ ```
178
+ /jacked that shopping cart feature I was building
179
+ ```
180
+
181
+ Claude finds it and you can continue right where you left off.
182
+
183
+ ### Example: Learning from Teammates
184
+
185
+ Your teammate Sam already built something similar:
186
+
187
+ ```
188
+ /jacked how did Sam implement the payment system
189
+ ```
190
+
191
+ You can see Sam's approach without bothering them.
192
+
193
+ ---
194
+
195
+ ## Working with Your Team
196
+
197
+ Share knowledge across your team by using the same cloud database.
198
+
199
+ ### Setting Up Team Sharing
200
+
201
+ 1. **One person** creates a Qdrant Cloud account and shares the credentials
202
+ 2. **Everyone** adds the same credentials to their computer
203
+ 3. **Each person** sets their name so sessions are attributed correctly
204
+
205
+ ```bash
206
+ # Everyone uses the same database
207
+ export QDRANT_CLAUDE_SESSIONS_ENDPOINT="https://team-cluster.qdrant.io"
208
+ export QDRANT_CLAUDE_SESSIONS_API_KEY="team-api-key"
209
+
210
+ # Each person sets their own name
211
+ export JACKED_USER_NAME="sarah"
212
+ ```
213
+
214
+ ### Searching Team Sessions
215
+
216
+ ```
217
+ /jacked payment processing # Shows your work first, then teammates
218
+ /jacked payment processing --mine # Only your sessions
219
+ /jacked payment processing --user sam # Only Sam's sessions
220
+ ```
221
+
222
+ ---
223
+
224
+ ## Built-in Reviewers and Commands
225
+
226
+ ### Quick Commands
227
+
228
+ Type these directly in Claude Code:
229
+
230
+ | Command | What It Does |
231
+ |---------|--------------|
232
+ | `/dc` | **Double-check** — Reviews your recent work for bugs, security issues, and problems |
233
+ | `/pr` | **Pull Request** — Checks PR status, creates/updates PRs with proper issue linking |
234
+ | `/learn` | **Learn** — Distills a lesson from the current session into a CLAUDE.md rule |
235
+ | `/redo` | **Redo** — Scraps the current approach and re-implements cleanly with full hindsight |
236
+ | `/techdebt` | **Tech Debt** — Scans for TODOs, oversized files, missing tests, dead code |
237
+ | `/audit-rules` | **Audit Rules** — Checks CLAUDE.md for duplicates, contradictions, stale rules |
238
+
239
+ ### Smart Reviewers
240
+
241
+ These work automatically when Claude thinks they'd help, or you can ask for them:
242
+
243
+ | Reviewer | What It Catches |
244
+ |----------|-----------------|
245
+ | **Double-check** | Security holes, authentication gaps, data leaks |
246
+ | **Code Simplicity** | Over-complicated code, unnecessary abstractions |
247
+ | **Error Handler** | Missing error handling, potential crashes |
248
+ | **Test Coverage** | Untested code, missing edge cases |
249
+
250
+ **Example:** After building a new feature:
251
+ ```
252
+ Use the double-check reviewer to review what we just built
253
+ ```
254
+
255
+ ---
256
+
257
+ ## Security Gatekeeper
258
+
259
+ The security gatekeeper is a PreToolUse hook that intercepts every bash command Claude runs and decides whether to auto-approve it or ask you first.
260
+
261
+ ### How It Works
262
+
263
+ A 4-tier evaluation chain, fastest first:
264
+
265
+ | Tier | Speed | What It Does |
266
+ |------|-------|--------------|
267
+ | **Deny patterns** | <1ms | Blocks dangerous commands (sudo, rm -rf /, disk wipe, etc.) |
268
+ | **Permission rules** | <1ms | Checks commands already approved in your Claude settings |
269
+ | **Local allowlist** | <1ms | Matches safe patterns (git, pytest, linting, docker, etc.) |
270
+ | **LLM evaluation** | ~2s | Sends ambiguous commands to Haiku for safety evaluation |
271
+
272
+ About 90% of commands resolve in under 2 milliseconds. The LLM tier also reads the contents of referenced Python/SQL/shell scripts and evaluates what the code actually does.
273
+
274
+ ### Install / Uninstall
275
+
276
+ The security gatekeeper is opt-in. To enable it:
277
+
278
+ ```bash
279
+ pip install "claude-jacked[security]"
280
+ jacked install --security
281
+ ```
282
+
283
+ To remove just the security hook:
284
+ ```bash
285
+ jacked uninstall --security
286
+ ```
287
+
288
+ ### Debug Logging
289
+
290
+ ```bash
291
+ # Always-on log (decisions only)
292
+ cat ~/.claude/hooks-debug.log
293
+
294
+ # Verbose debug mode
295
+ export JACKED_HOOK_DEBUG=1
296
+ ```
297
+
298
+ ### Faster LLM Evaluation
299
+
300
+ If you have an Anthropic API key, the gatekeeper uses the SDK directly (~2s) instead of the CLI fallback (~8s):
301
+
302
+ ```bash
303
+ pip install anthropic # or: pip install claude-jacked[security]
304
+ export ANTHROPIC_API_KEY="sk-..."
305
+ ```
306
+
307
+ ---
308
+
309
+ ## Sound Notifications
310
+
311
+ Get audio alerts so you don't have to watch the terminal:
312
+
313
+ ```bash
314
+ jacked install --sounds
315
+ ```
316
+
317
+ - **Notification sound** — Plays when Claude needs your input
318
+ - **Completion sound** — Plays when Claude finishes a task
319
+
320
+ Works on Windows, Mac, and Linux. To remove sounds later:
321
+ ```bash
322
+ jacked uninstall --sounds
323
+ ```
324
+
325
+ ---
326
+
327
+ ## Uninstall
328
+
329
+ **Remove everything:**
330
+ ```bash
331
+ jacked uninstall && pipx uninstall claude-jacked
332
+ ```
333
+
334
+ **Or one-liner:**
335
+ ```bash
336
+ curl -sSL https://raw.githubusercontent.com/jackneil/claude-jacked/master/uninstall.sh | bash
337
+ ```
338
+
339
+ Your cloud database stays intact, so you won't lose your history if you reinstall later.
340
+
341
+ ---
342
+
343
+ ## Common Issues
344
+
345
+ ### "I installed it but search isn't working"
346
+
347
+ You need to set up the cloud database first. Ask Claude:
348
+ ```
349
+ Help me set up Qdrant Cloud for jacked
350
+ ```
351
+
352
+ ### "It says 'jacked: command not found'"
353
+
354
+ The install didn't add jacked to your PATH. Try:
355
+ ```bash
356
+ pipx ensurepath
357
+ ```
358
+ Then restart your terminal.
359
+
360
+ ### "My sessions aren't showing up in search"
361
+
362
+ Run this to index your existing sessions:
363
+ ```bash
364
+ jacked backfill
365
+ ```
366
+
367
+ ### "I'm on Windows and getting weird errors"
368
+
369
+ Claude Code on Windows uses Git Bash, which can have path issues. Ask Claude:
370
+ ```
371
+ Help me fix jacked path issues on Windows
372
+ ```
373
+
374
+ ---
375
+
376
+ ## Cloud Database Setup (Qdrant)
377
+
378
+ > **This is only needed if you installed the `[search]` extra.** The base install works fine without Qdrant.
379
+
380
+ The session search feature stores your conversations in a cloud database so you can access them from any computer.
381
+
382
+ ### Why Qdrant?
383
+
384
+ - **Smart search** — Find sessions by meaning, not just keywords
385
+ - **Works everywhere** — Access from any computer
386
+ - **Team sharing** — Everyone can search the same database
387
+ - **You control it** — Your data stays in your own database
388
+
389
+ ### Setting Up Qdrant Cloud
390
+
391
+ 1. Install the search extra: `pip install "claude-jacked[search]"`
392
+ 2. Go to [cloud.qdrant.io](https://cloud.qdrant.io) and create an account
393
+ 3. Create a new cluster (the paid tier ~$30/month is required for the search features)
394
+ 4. Copy your cluster URL and API key
395
+ 5. Add them to your shell profile:
396
+
397
+ **Mac/Linux** — Add to `~/.bashrc` or `~/.zshrc`:
398
+ ```bash
399
+ export QDRANT_CLAUDE_SESSIONS_ENDPOINT="https://your-cluster.qdrant.io"
400
+ export QDRANT_CLAUDE_SESSIONS_API_KEY="your-api-key"
401
+ ```
402
+
403
+ **Windows** — Add to your environment variables, or add to `~/.bashrc` in Git Bash.
404
+
405
+ 6. Restart your terminal and run:
406
+ ```bash
407
+ jacked backfill # Index your existing sessions
408
+ jacked status # Verify it's working
409
+ ```
410
+
411
+ ---
412
+
413
+ ## Security Note
414
+
415
+ **Your conversations are sent to Qdrant Cloud.** This includes:
416
+ - Everything you and Claude discuss
417
+ - Code snippets you share
418
+ - File paths on your computer
419
+
420
+ **Recommendations:**
421
+ - Don't paste passwords or API keys in Claude sessions
422
+ - Keep your Qdrant API key private
423
+ - For sensitive work, consider self-hosting Qdrant
424
+
425
+ ---
426
+
427
+ ## Advanced / Technical Reference
428
+
429
+ <details>
430
+ <summary><strong>CLI Command Reference</strong></summary>
431
+
432
+ ```bash
433
+ # Search
434
+ jacked search "query" # Search all sessions
435
+ jacked search "query" --mine # Only your sessions
436
+ jacked search "query" --user name # Specific teammate
437
+ jacked search "query" --repo path # Boost specific repo
438
+
439
+ # Session Management
440
+ jacked sessions # List indexed sessions
441
+ jacked retrieve <session_id> # Get session content
442
+ jacked retrieve <id> --mode full # Get full transcript
443
+ jacked delete <session_id> # Remove from index
444
+ jacked cleardb # Delete all your data
445
+
446
+ # Setup
447
+ jacked install # Install agents, commands, rules
448
+ jacked install --search # Also add session indexing hook
449
+ jacked install --security # Also add security gatekeeper hook
450
+ jacked install --sounds # Also add sound notifications
451
+ jacked uninstall # Remove from Claude Code
452
+ jacked uninstall --sounds # Remove only sounds
453
+ jacked uninstall --security # Remove only security hook
454
+ jacked backfill # Index all existing sessions (requires [search])
455
+ jacked backfill --force # Re-index everything
456
+ jacked status # Check connectivity (requires [search])
457
+ jacked configure --show # Show current config
458
+ ```
459
+
460
+ </details>
461
+
462
+ <details>
463
+ <summary><strong>Environment Variables</strong></summary>
464
+
465
+ **Required:**
466
+ | Variable | Description |
467
+ |----------|-------------|
468
+ | `QDRANT_CLAUDE_SESSIONS_ENDPOINT` | Your Qdrant Cloud URL |
469
+ | `QDRANT_CLAUDE_SESSIONS_API_KEY` | Your Qdrant API key |
470
+
471
+ **Optional:**
472
+ | Variable | Default | Description |
473
+ |----------|---------|-------------|
474
+ | `JACKED_USER_NAME` | git username | Your name for team attribution |
475
+ | `JACKED_TEAMMATE_WEIGHT` | 0.8 | How much to weight teammate results |
476
+ | `JACKED_OTHER_REPO_WEIGHT` | 0.7 | How much to weight other repos |
477
+ | `JACKED_TIME_DECAY_HALFLIFE_WEEKS` | 35 | How fast old sessions lose relevance |
478
+ | `JACKED_HOOK_DEBUG` | (unset) | Set to `1` for verbose security hook logging |
479
+ | `ANTHROPIC_API_KEY` | (unset) | Enables fast (~2s) LLM evaluation in security hook |
480
+
481
+ </details>
482
+
483
+ <details>
484
+ <summary><strong>How It Works (Technical)</strong></summary>
485
+
486
+ ```
487
+ ┌─────────────────────────────────────────────────────────────┐
488
+ │ YOUR MACHINE │
489
+ │ │
490
+ │ Claude Code │
491
+ │ ├── Stop hook → jacked index (after every response) │
492
+ │ └── /jacked skill → search + load context │
493
+ │ │
494
+ │ ~/.claude/projects/ │
495
+ │ └── {repo}/ │
496
+ │ └── {session}.jsonl ←── parsed and indexed │
497
+ └─────────────────────────────────────────────────────────────┘
498
+
499
+ │ HTTPS
500
+
501
+ ┌─────────────────────────────────────────────────────────────┐
502
+ │ QDRANT CLOUD │
503
+ │ │
504
+ │ • Server-side embedding (no local ML needed) │
505
+ │ • Vectors + transcripts stored │
506
+ │ • Accessible from any machine │
507
+ └─────────────────────────────────────────────────────────────┘
508
+ ```
509
+
510
+ **Indexing:** After each Claude response, a hook automatically indexes the session to Qdrant. The indexer extracts:
511
+ - Plan files (implementation strategies)
512
+ - Agent summaries (exploration results)
513
+ - Summary labels (chapter titles from auto-compaction)
514
+ - User messages (for intent matching)
515
+
516
+ **Retrieval modes:**
517
+ - `smart` (default): Plan + summaries + labels (~5-10K tokens)
518
+ - `full`: Complete transcript (50-200K tokens)
519
+ - `plan`: Just the plan file
520
+ - `agents`: Just agent summaries
521
+ - `labels`: Just summary labels (tiny)
522
+
523
+ </details>
524
+
525
+ <details>
526
+ <summary><strong>All Agents</strong></summary>
527
+
528
+ | Agent | Description |
529
+ |-------|-------------|
530
+ | `double-check-reviewer` | CTO/CSO-level review for security, auth gaps, data leaks |
531
+ | `code-simplicity-reviewer` | Reviews for over-engineering and unnecessary complexity |
532
+ | `defensive-error-handler` | Audits error handling and adds defensive patterns |
533
+ | `git-pr-workflow-manager` | Manages branches, commits, and PR organization |
534
+ | `pr-workflow-checker` | Checks PR status and handles PR lifecycle |
535
+ | `issue-pr-coordinator` | Scans issues, groups related ones, manages PR workflows |
536
+ | `test-coverage-engineer` | Analyzes and improves test coverage |
537
+ | `test-coverage-improver` | Adds doctests and test files systematically |
538
+ | `readme-maintainer` | Keeps README in sync with code changes |
539
+ | `wiki-documentation-architect` | Creates/maintains GitHub Wiki documentation |
540
+
541
+ </details>
542
+
543
+ <details>
544
+ <summary><strong>Hook Configuration</strong></summary>
545
+
546
+ The `jacked install` command adds hooks to `~/.claude/settings.json` based on installed extras:
547
+
548
+ ```json
549
+ // With [search] extra installed:
550
+ {
551
+ "hooks": {
552
+ "Stop": [{
553
+ "matcher": "",
554
+ "hooks": [{
555
+ "type": "command",
556
+ "command": "jacked index --repo \"$CLAUDE_PROJECT_DIR\"",
557
+ "async": true
558
+ }]
559
+ }]
560
+ }
561
+ }
562
+
563
+ // With --security flag:
564
+ {
565
+ "hooks": {
566
+ "PreToolUse": [{
567
+ "matcher": "Bash",
568
+ "hooks": [{
569
+ "type": "command",
570
+ "command": "python /path/to/security_gatekeeper.py",
571
+ "timeout": 30
572
+ }]
573
+ }]
574
+ }
575
+ }
576
+ ```
577
+
578
+ </details>
579
+
580
+ <details>
581
+ <summary><strong>Guided Install Prompt (for Claude)</strong></summary>
582
+
583
+ Copy this into Claude Code for a guided installation:
584
+
585
+ ```
586
+ Install claude-jacked for me. Use the AskUserQuestion tool to guide me through options.
587
+
588
+ PHASE 1 - DIAGNOSTICS:
589
+ - Detect OS (Windows/Mac/Linux)
590
+ - Check: pipx --version (if missing: pip install pipx && pipx ensurepath)
591
+ - Check: jacked --version (to see if already installed)
592
+ - Check ~/.claude/settings.json for existing hooks
593
+
594
+ PHASE 2 - ASK USER PREFERENCES:
595
+ Use AskUserQuestion with these options:
596
+
597
+ Question: "Which jacked features do you want?"
598
+ Options:
599
+ - BASE (Recommended): Smart reviewers (/dc, /pr, /learn, /redo, /techdebt), 10 agents, behavioral rules. No external services needed.
600
+ - SEARCH: Everything in BASE + search past Claude sessions across machines. Requires Qdrant Cloud (~$30/mo).
601
+ - SECURITY: Everything in BASE + auto-approve safe bash commands. Fewer permission prompts, uses Anthropic API.
602
+ - ALL: Everything. Requires Qdrant Cloud + Anthropic API key for fastest security evaluation.
603
+
604
+ PHASE 3 - INSTALL:
605
+ Based on user choice:
606
+ - BASE: pipx install claude-jacked && jacked install
607
+ - SEARCH: pipx install "claude-jacked[search]" && jacked install
608
+ - SECURITY: pipx install "claude-jacked[security]" && jacked install --security
609
+ - ALL: pipx install "claude-jacked[all]" && jacked install --security
610
+
611
+ PHASE 4 - POST-INSTALL (if SEARCH or ALL):
612
+ Help user set up Qdrant Cloud:
613
+ 1. Go to cloud.qdrant.io, create account
614
+ 2. Create cluster (paid tier required)
615
+ 3. Copy endpoint URL and API key
616
+ 4. Add to shell profile:
617
+ export QDRANT_CLAUDE_SESSIONS_ENDPOINT="https://..."
618
+ export QDRANT_CLAUDE_SESSIONS_API_KEY="..."
619
+ 5. Restart terminal
620
+ 6. Run: jacked backfill
621
+
622
+ PHASE 5 - VERIFY:
623
+ - jacked --help (should show all commands)
624
+ - jacked configure --show (if SEARCH installed)
625
+
626
+ WINDOWS NOTE: If env vars not visible in Git Bash, check Windows system env vars:
627
+ powershell.exe -Command "[System.Environment]::GetEnvironmentVariable('QDRANT_CLAUDE_SESSIONS_ENDPOINT', 'User')"
628
+ ```
629
+
630
+ </details>
631
+
632
+ <details>
633
+ <summary><strong>Windows Troubleshooting</strong></summary>
634
+
635
+ Claude Code uses Git Bash on Windows, which can cause path issues.
636
+
637
+ **Where jacked is installed:**
638
+ ```
639
+ C:\Users\<username>\pipx\venvs\claude-jacked\Scripts\jacked.exe
640
+ ```
641
+
642
+ **If "jacked" isn't found:**
643
+ ```bash
644
+ # Find it
645
+ where jacked
646
+
647
+ # Or add to PATH
648
+ pipx ensurepath
649
+ ```
650
+
651
+ **If paths are getting mangled:**
652
+ Use forward slashes in Git Bash:
653
+ ```bash
654
+ /c/Users/jack/pipx/venvs/claude-jacked/Scripts/jacked.exe status
655
+ ```
656
+
657
+ </details>
658
+
659
+ ---
660
+
661
+ ## License
662
+
663
+ MIT
664
+
665
+ ## Credits
666
+
667
+ Built for [Claude Code](https://claude.ai/code) by Anthropic. Uses [Qdrant](https://qdrant.tech/) for search.
@@ -0,0 +1,33 @@
1
+ jacked/__init__.py,sha256=XTk840YXqNFn8qtUqHjvCehDWYX8Zb-Dnyq1b-BjsEQ,1276
2
+ jacked/cli.py,sha256=Rl0tQezh6e1ff0t8_KlfIg6I3x67MMQCvu6J8GEpyZY,51386
3
+ jacked/client.py,sha256=7N4GdjcG8OXfmjUfprlUOJTkyrPyqF1OBstAsplNSa8,18151
4
+ jacked/config.py,sha256=DeC1no5rFsvlb6JaU2PzLyyhI4DaJrxrsfqVugWuC4Q,8606
5
+ jacked/index_write_tracker.py,sha256=E1zVqyZTQdHenp_vXL-gWPvLBo18Ar703_0MI9Cst8U,8679
6
+ jacked/indexer.py,sha256=Ox4W53X9pYleX32HllrsY3dFydrkRN5enMn3fYKkRms,17998
7
+ jacked/retriever.py,sha256=Lehq8zpQJzY9f7DmM9DfqUulZoVBHgpvWuasUgouxxw,19454
8
+ jacked/searcher.py,sha256=X6fIhVtIybUNpw69EUPY9-rsIdeBWZSmaCEC8EEXdbw,12994
9
+ jacked/transcript.py,sha256=QXm1xJd15n_-tvrXpNpsY-968Y68yKXeHjN0EgLKg6s,24421
10
+ jacked/data/agents/code-simplicity-reviewer.md,sha256=K_dqHP-h30fMeSGnUnq0hG4RJXDNnsKHDhchsuQ5YfA,5550
11
+ jacked/data/agents/defensive-error-handler.md,sha256=bE4oZSz_pFHE-LtzEqLL1TB8NH-YjY0cAveXQLgbjDM,5558
12
+ jacked/data/agents/double-check-reviewer.md,sha256=mrtcg-D-1R2qMzzIp64NzHW6dqbDf30eNinRS_aTCFI,9772
13
+ jacked/data/agents/git-pr-workflow-manager.md,sha256=owsusEBk1-ms4yvzzlyv32EKvkrp5oVQNHFw8GopHTE,8145
14
+ jacked/data/agents/issue-pr-coordinator.md,sha256=I9qUM6xQuNUfvNR4vDV1BYFczx3VZvZv7clKldUT8pc,7354
15
+ jacked/data/agents/pr-workflow-checker.md,sha256=IwuTCI7L7Z_DfScn-1e0UvrmMWhX6yLTBMiLBZyUPtE,6751
16
+ jacked/data/agents/readme-maintainer.md,sha256=z2CVCf9JR1qg3X6tPm69EmBbCGvIDCSJcVk9t-OtiF4,7464
17
+ jacked/data/agents/test-coverage-engineer.md,sha256=56LaFTyOocwclgNF6LBsPKZJSNoDLIfV8FzYrKao7wo,7555
18
+ jacked/data/agents/test-coverage-improver.md,sha256=q7IJtXX0rWwgcMqskSYqqXew4sEobH-Y4u8G3SpPr-Q,6607
19
+ jacked/data/agents/wiki-documentation-architect.md,sha256=x9qIAeNEH--4-d2hbhnhIFxpZ1lCg-wji9T29agmEoM,15812
20
+ jacked/data/commands/audit-rules.md,sha256=9gZMtqMhAYqbdlIvg2RWrBFCaFXvfYf1obQC-dV7tu4,3967
21
+ jacked/data/commands/dc.md,sha256=SG__jWSyb13Jgxb9A8yBdMfC3T3hHWiGyDP0v_1di0o,7622
22
+ jacked/data/commands/learn.md,sha256=FoD-qKsQSpEayFNP997dyUfV4UJgs8LiojYIWnzOSvA,3992
23
+ jacked/data/commands/pr.md,sha256=1orTbDnL4ky2bk5VXm5j66hGybTrNWVTyAPxx_uMggU,193
24
+ jacked/data/commands/redo.md,sha256=4NnCKKi10ybEOHdFObN1aVNaFGOt63eoluwDJUzUFxg,4242
25
+ jacked/data/commands/techdebt.md,sha256=jSdfMN1Kvz6vmsnWw9sCMFpKA8r87e9nDHrE-qsMwG8,3861
26
+ jacked/data/hooks/security_gatekeeper.py,sha256=nhiT4X-8zBhjG-i1hKgQzoXNE3NOnekTYGDlns72iXk,14083
27
+ jacked/data/rules/jacked_behaviors.md,sha256=x1qzdj3DLmkhv5TVAdNyIpAdjBGz7IUdXSrko94LOOw,1449
28
+ jacked/data/skills/jacked/SKILL.md,sha256=IEMp-PfWlu5rmS1R5HHblUX1CGwzno2gtO4yQ2cMAg4,5488
29
+ claude_jacked-0.3.0.dist-info/METADATA,sha256=6Jf7_HXb_Ehv2l2WRCCBLwnyNpigE6luFNAnpSQ51XA,22091
30
+ claude_jacked-0.3.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
31
+ claude_jacked-0.3.0.dist-info/entry_points.txt,sha256=52JDhetd7OsE9iJryGrQIL3PWhum_QCeLuTeQ9-CTqQ,43
32
+ claude_jacked-0.3.0.dist-info/licenses/LICENSE,sha256=m8NmsH7P5G4VH3VyHWPQUTl2weuNTh1-eaH0RbUcn3k,1066
33
+ claude_jacked-0.3.0.dist-info/RECORD,,