starred/nix-config
1
0
Fork 0
mirror of https://github.com/ryan4yin/nix-config.git synced 2026-09-01 07:47:12 +02:00
Code Issues Packages Projects Releases 10 Wiki Activity

docs(agents): clarify shell and script guidance

Browse Source
This commit is contained in:
Ryan Yin
2026-08-31 13:54:03 +08:00
parent de35352e48
commit 01622bf6d6
1 changed files with 10 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files
agents/AGENTS.md
+10 -3
View File
@@ -80,8 +80,6 @@ Once at the start of each repository session:
- Primary platforms are NixOS and macOS. - Primary platforms are NixOS and macOS.
- Prefer existing task runners and specialized CLI tools over reimplementing their behavior. - Prefer existing task runners and specialized CLI tools over reimplementing their behavior.
- **Use Python for ad hoc scripts or composed logic.** Use Bash only for simple one-shot commands
that are clearly shorter and verified. Simple one-shot Python scripts do not require tests.
- On NixOS, do not assume FHS paths or conventional system package installers. Use `nix run`, the - On NixOS, do not assume FHS paths or conventional system package installers. Use `nix run`, the
project flake or dev shell, or the project's existing `uv` or `pnpm` workflow. Ask before using a project flake or dev shell, or the project's existing `uv` or `pnpm` workflow. Ask before using a
different installation method. different installation method.
@@ -92,8 +90,17 @@ Once at the start of each repository session:
`ssh -F /dev/null` or `GIT_SSH_COMMAND`. If sandbox ownership checks reject the Nix-managed `ssh -F /dev/null` or `GIT_SSH_COMMAND`. If sandbox ownership checks reject the Nix-managed
config, rerun the original Git command with elevated permission. config, rerun the original Git command with elevated permission.
## Commands and scripts ## Shell and scripts
- On the user's personal machines, use Nushell for short local commands and lightweight
orchestration, whether interactive or automatic. Prefer structured values and operations over
parsing text. Direct executable invocations are shell-neutral and need no wrapper.
- Use Bash only for simple shell commands in project files or documentation and for simple commands
intended for others. Follow the target shell for remote hosts, CI, containers, and existing
scripts; default to Bash when the context is unclear.
- Use Python when a task outgrows a short shell pipeline, whether Nushell or Bash, such as for
substantial control flow, error handling, polling, process supervision, or reusable logic. Simple
one-shot Python scripts do not require tests.
- Prefer native wait or subscription tools. Otherwise, poll with progress and an explicit deadline, - Prefer native wait or subscription tools. Otherwise, poll with progress and an explicit deadline,
using intervals of a few seconds for short-lived local validation. A timeout does not prove the using intervals of a few seconds for short-lived local validation. A timeout does not prove the
process is still running. process is still running.