# AGENTS.md

## Nix
- Enter a dev shell with `nix develop`
- Assume nothing will work outside of the shell
- See/edit `flake.nix` for relevant concerns

## Deno
- Manage dependencies with `deno add` and `deno remove` in `./src` directory
- Deno maintains its own `deno.lock` which Nix picks up
- IMPORTANT: never use JSR dependencies, only NPM
- Example: `deno add npm:chalk` then `import chalk from "chalk";` in `.ts` files

## Project conventions
- Entry points are CLI subcommands (`./src/main.ts`)
- Use `@stricli/core` for CLI
- Prefer to do things by running shell commands via `dax-sh`
- Verbosity implies `$.setPrintCommand(true)` for `dax-sh` to output what it runs
- Logs always go to `stderr` so that `stdout` can be redirected to a file safely