20 lines
756 B
Markdown
20 lines
756 B
Markdown
|
# 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
|