{"id":50910910,"url":"https://github.com/nihildigit/coding-agents-setup","last_synced_at":"2026-06-16T10:01:24.412Z","repository":{"id":359596061,"uuid":"1246654158","full_name":"NihilDigit/coding-agents-setup","owner":"NihilDigit","description":"Modern local toolchain setup scripts for coding agents","archived":false,"fork":false,"pushed_at":"2026-05-22T16:10:50.000Z","size":76,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-22T19:52:23.694Z","etag":null,"topics":["claude-code","codex","coding-agents","powershell"],"latest_commit_sha":null,"homepage":null,"language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NihilDigit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/security.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-22T12:13:13.000Z","updated_at":"2026-05-22T17:21:33.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/NihilDigit/coding-agents-setup","commit_stats":null,"previous_names":["nihildigit/coding-agents-setup"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/NihilDigit/coding-agents-setup","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NihilDigit%2Fcoding-agents-setup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NihilDigit%2Fcoding-agents-setup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NihilDigit%2Fcoding-agents-setup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NihilDigit%2Fcoding-agents-setup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NihilDigit","download_url":"https://codeload.github.com/NihilDigit/coding-agents-setup/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NihilDigit%2Fcoding-agents-setup/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34400456,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-16T02:00:06.860Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","codex","coding-agents","powershell"],"created_at":"2026-06-16T10:01:23.374Z","updated_at":"2026-06-16T10:01:24.404Z","avatar_url":"https://github.com/NihilDigit.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Coding Agents Setup\n\nA modern local toolchain setup for coding agents. It installs or writes user-level configuration for Codex and Claude, with Windows and Linux behavior kept separate.\n\n## TL;DR\n\nThis repo turns local coding-agent conventions into installable rule files and setup scripts: available tools, package-manager preferences, file deletion behavior, operations that require user confirmation, and platform differences.\n\nIt has a clear preference for newer tools: `uv` for Python, `bun` for JavaScript/TypeScript, and command-line replacements such as `rg`, `fd`, and `eza`.\n\nManaged config files are backed up before replacement. CI runs installation and behavior smoke checks on Ubuntu and Windows, which gives a basic reliability check but cannot cover every local environment.\n\n## Install\n\nReview the scripts before running remote bootstrap commands. They download code and execute it locally.\n\nBy default, bootstrap downloads the commit from the latest successful GitHub Actions smoke run triggered by a `ci-*` tag.\n\nWindows:\n\n```powershell\nirm https://raw.githubusercontent.com/NihilDigit/coding-agents-setup/main/install.ps1 | iex\n```\n\nLinux:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/NihilDigit/coding-agents-setup/main/install.sh | bash\n```\n\nFrom a cloned checkout:\n\n```powershell\n.\\setup-windows.ps1 -Agent Both\n```\n\n```bash\n./setup-linux.sh --agent both\n```\n\nTest a branch instead of the latest tested tag:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/NihilDigit/coding-agents-setup/main/install.sh | REF=main REF_KIND=branch bash\n```\n\n```powershell\n\u0026 ([scriptblock]::Create((irm https://raw.githubusercontent.com/NihilDigit/coding-agents-setup/main/install.ps1))) -Ref main -RefKind branch\n```\n\n## Windows\n\nWindows is the full interactive setup. It can install the toolchain, write Codex/Claude rule files, write a PowerShell profile, make `rm` send files to the Recycle Bin, set up Agent Skills directories, install `rtk`, and optionally install Kimi WebBridge.\n\nThe Windows bootstrap installs PowerShell 7 (`pwsh`) by default, runs setup through it, sets the current user's execution policy to `RemoteSigned`, and tries to make PowerShell 7 the default Windows Terminal profile. If a cloned checkout is blocked before the script can start, launch it once with:\n\n```powershell\npowershell -ExecutionPolicy Bypass -File .\\setup-windows.ps1 -Agent Both\n```\n\nPowerShell profile writing is interactive. The default profile adds PATH entries and helper functions. A second prompt enables Unix-style aliases, including safe `rm -\u003e trash` shadowing; the default is yes.\n\nKimi WebBridge is offered by default and can be declined. It downloads and executes Kimi's current installer, and browser extension/profile access may be required for browser automation.\n\n`-Yes` accepts every setup prompt, including prompts whose interactive default is no:\n\n```powershell\n.\\setup-windows.ps1 -Agent Both -Yes\n```\n\nRules only:\n\n```powershell\n.\\setup-windows.ps1 -Agent Codex -SkipTools -SkipProfile\n```\n\n## Linux\n\nLinux distributions and desktop environments vary too much for one fixed install flow. The Linux setup writes rule files first, installs `~/.local/bin/clip-run`, and includes a temporary first-run task for the agent to inspect the machine and ask what to configure.\n\nIt does not install system packages or modify shell profiles.\n\nOn Arch-like systems, generated rules add Arch-specific guidance: use `paru -S` or `sudo pacman -S`, prefer `*-bin` AUR packages when available, use system `trash-cli`, and configure sudoers narrowly for `/usr/bin/pacman` and `/usr/bin/paru`.\n\n`clip-run` is used when an agent needs user confirmation or `sudo`: it writes a script to `/tmp` and copies the command for the user to run manually.\n\nAfter the first Linux setup pass, delete the temporary `Linux Initial Setup Task` section from the generated agent file.\n\n## Safety\n\nSilent install and update are acceptable when scoped to the requested setup. Silent deletion is not.\n\nPersistent files are backed up before replacement:\n\n- Linux: adjacent `*.bak-\u003ctimestamp\u003e` backups for generated agent rules and `~/.local/bin/clip-run`.\n- Windows: backups under `~/.coding-agents-backup-\u003ctimestamp\u003e` for generated rules, PowerShell profiles, setup selection state, and `~/.local/bin/rtk.exe`.\n- Windows skills layout: existing `~/.claude/skills` links or directories are moved to `.old-\u003ctimestamp\u003e`.\n\n## Verify\n\nLinux:\n\n```bash\n./verify-linux.sh --feature trash\n./verify-linux.sh --command paru --feature arch-sudoers\n./verify-linux.sh\nbash tests/Smoke-Linux.sh\n```\n\nWindows:\n\n```powershell\n.\\verify-windows.ps1\n.\\tests\\Smoke-Windows.ps1\n```\n\nRepository checks:\n\n```powershell\npwsh -NoLogo -NoProfile -File tests/Test-Setup.ps1\n```\n\nGitHub Actions runs smoke tests on Ubuntu and Windows when a `ci-*` tag is pushed:\n\n```bash\ntag=\"ci-$(date -u +%Y%m%d%H%M%S)\"\ngit tag --no-sign \"$tag\"\ngit push origin \"$tag\"\n```\n\n## Rule Fragments\n\nShared:\n\n```text\nrules/AGENTS.shared.md\nrules/AGENTS.codex.md\nrules/CLAUDE.md\n```\n\nPlatform:\n\n```text\nrules/AGENTS.windows.md\nrules/AGENTS.linux.md\nrules/AGENTS.linux-arch.md\nrules/AGENTS.linux-initial-setup.md\n```\n\n`AGENTS.linux-arch.md` is included only when `/etc/os-release` reports `ID=arch` or `ID_LIKE` contains `arch`.\n\n## Agent Targets\n\nWindows `-Agent`: `Codex`, `Claude`, `Both`, `None`, `Prompt`.\n\nLinux `--agent`: `codex`, `claude`, `both`, `none`, `prompt`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnihildigit%2Fcoding-agents-setup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnihildigit%2Fcoding-agents-setup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnihildigit%2Fcoding-agents-setup/lists"}