Request: Add totally manual install instructions

[Derjyn]

The "installer" often breaks. Having a clear manual install path would be helpful in these scenarios: what files to copy and where to copy them to, what lines to add various documents, what directories to create, etc.

It seems there has been a little pushback on this or at least avoidance, not sure if there is reasoning behind having a solid documented manual install approach.

I'm on Windows using Claude Code, and attempted to follow install instructions with all the various approaches, to no avail. Nothing gets copied to hooks for example. Lines get added to CLAUDE.md, but the installer complains about various things.

[Derjyn]

For reference, there are a bunch of warnings, and it looks like Claude related stuff such as hooks, settings.json and the CLAUDE.md tasks have warnings - they're never used and such... This is output when using the Cargo install approach, which thankfully outputs this helpful information to the console:

warning: constant `REWRITE_HOOK` is never used
  --> src\hooks\init.rs:13:7
   |
13 | const REWRITE_HOOK: &str = include_str!("../../hooks/claude/rtk-rewrite.sh");
   |       ^^^^^^^^^^^^
   |
   = note: `#[warn(dead_code)]` (part of `#[warn(unused)]`) on by default

warning: constant `FILTERS_TEMPLATE` is never used
  --> src\hooks\init.rs:26:7
   |
26 | const FILTERS_TEMPLATE: &str = r#"# Project-local RTK filters — commit this file with your repo.
   |       ^^^^^^^^^^^^^^^^

warning: constant `FILTERS_GLOBAL_TEMPLATE` is never used
  --> src\hooks\init.rs:42:7
   |
42 | const FILTERS_GLOBAL_TEMPLATE: &str = r#"# User-global RTK filters — apply to all your projects.
   |       ^^^^^^^^^^^^^^^^^^^^^^^

warning: enum `PatchResult` is never used
  --> src\hooks\init.rs:66:10
   |
66 | pub enum PatchResult {
   |          ^^^^^^^^^^^

warning: function `prepare_hook_paths` is never used
   --> src\hooks\init.rs:299:4
    |
299 | fn prepare_hook_paths() -> Result<(PathBuf, PathBuf)> {
    |    ^^^^^^^^^^^^^^^^^^

warning: function `prompt_user_consent` is never used
   --> src\hooks\init.rs:416:4
    |
416 | fn prompt_user_consent(settings_path: &Path) -> Result<bool> {
    |    ^^^^^^^^^^^^^^^^^^^

warning: function `print_manual_instructions` is never used
   --> src\hooks\init.rs:439:4
    |
439 | fn print_manual_instructions(hook_path: &Path, include_opencode: bool) {
    |    ^^^^^^^^^^^^^^^^^^^^^^^^^

warning: function `patch_settings_json` is never used
   --> src\hooks\init.rs:696:4
    |
696 | fn patch_settings_json(
    |    ^^^^^^^^^^^^^^^^^^^

warning: function `insert_hook_entry` is never used
   --> src\hooks\init.rs:814:4
    |
814 | fn insert_hook_entry(root: &mut serde_json::Value, hook_command: &str) {
    |    ^^^^^^^^^^^^^^^^^

warning: function `generate_project_filters_template` is never used
   --> src\hooks\init.rs:971:4
    |
971 | fn generate_project_filters_template(verbose: u8) -> Result<()> {
    |    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

warning: function `generate_global_filters_template` is never used
   --> src\hooks\init.rs:995:4
    |
995 | fn generate_global_filters_template(verbose: u8) -> Result<()> {
    |    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

warning: function `patch_claude_md` is never used
    --> src\hooks\init.rs:1356:4
     |
1356 | fn patch_claude_md(path: &Path, verbose: u8) -> Result<bool> {
     |    ^^^^^^^^^^^^^^^

warning: function `store_hash` is never used
  --> src\hooks\integrity.rs:66:8
   |
66 | pub fn store_hash(hook_path: &Path) -> Result<()> {
   |        ^^^^^^^^^^

[pszymkowiak]

[w] wshm · Automated triage by AI

🔍 Automated Triage

📋 Category	docs
🟡 Priority	medium
🎯 Confidence	92%

Summary

Request for comprehensive manual installation instructions to help users when the automated installer fails, particularly on Windows.

This looks like a simple fix. Only repo maintainers can trigger auto-fix.

---

Triaged automatically by wshm · This is an automated analysis, not a human review.