@nanobpm/nano-coder 0.37.1 → 0.38.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +76 -22
  2. package/package.json +5 -5
package/README.md CHANGED
@@ -458,7 +458,10 @@ verbosity = "normal" # quiet | normal | verbose | debug (or -
458
458
  renderer = "frame" # frame (default: app-owned redraw on resize) | legacy
459
459
  timestamps = true # prefix CLI messages with the local time (HH:MM:SS)
460
460
  project_instructions = true # load AGENTS.md etc. (see Project Instructions)
461
- project_instruction_files = ["AGENTS.md", "CLAUDE.md", ".github/copilot-instructions.md"]
461
+ project_instruction_files = ["AGENTS.md", "CLAUDE.md", ".claude/CLAUDE.md", ".github/copilot-instructions.md"]
462
+ user_instruction_files = ["~/.claude/CLAUDE.md", "~/.agents/AGENTS.md"] # yours, for every project
463
+ user_rules_dirs = ["~/.claude/rules"]
464
+ instruction_imports_outside_project = false # let project @imports / rule links leave the repo
462
465
  plan_tools = true # offer the plan_* tools (see Task Plans)
463
466
  outcome_tool = true # offer report_outcome (see Outcomes)
464
467
  reminders = true # append <system-reminder> notes to tool results
@@ -870,24 +873,61 @@ providers and models on synthetic or forked real sessions (see its README). See
870
873
 
871
874
  ## Project Instructions
872
875
 
873
- When a session starts, the harness looks for instruction files in every directory from the
874
- git root (the nearest ancestor containing `.git`) down to the working directory. Outside a
875
- repository only the working directory is checked. In each directory the first file found from
876
- `project_instruction_files` is used, so `AGENTS.md` wins over `CLAUDE.md`, which wins over
877
- `.github/copilot-instructions.md`. The files are appended to the system prompt, root first,
878
- under a "Repository instructions" heading that tells the model to follow them. So the model
879
- has them before it makes any change, without having to decide to read them. Each file is
880
- capped at 32 KiB and the total at 64 KiB.
881
-
882
- Instruction files deeper in the tree than the working directory, such as `pkg/AGENTS.md`,
883
- are loaded lazily. The first time `read_file`, `write_file` or `edit_file` touches a path
884
- under such a directory, its instructions are appended to that tool result, once per
885
- directory. After a compaction they are attached again the next time they apply. Files that
886
- the `bash` tool touches don't trigger this.
887
-
888
- Instructions are read again when a session is resumed, so edits to `AGENTS.md` take effect.
889
- `/context` lists the loaded files. To turn loading off, set `project_instructions = false`,
890
- or set `AGENTIC_NO_PROJECT_INSTRUCTIONS`.
876
+ nano-coder reads the instruction files you already have for other tools, including Claude
877
+ Code's, so there is nothing to duplicate.
878
+
879
+ **Your files.** Each file in `user_instruction_files` that exists (default `~/.claude/CLAUDE.md`
880
+ and `~/.agents/AGENTS.md`) is loaded first, under a "Your instructions" heading, followed by
881
+ the rules in `user_rules_dirs` (default `~/.claude/rules`).
882
+
883
+ **The repository's files.** When a session starts, the harness looks in every directory from
884
+ the git root (the nearest ancestor containing `.git`) down to the working directory. Outside
885
+ a repository only the working directory is checked. In each directory:
886
+
887
+ - the first file found from `project_instruction_files` is used, so `AGENTS.md` wins over
888
+ `CLAUDE.md`, then `.claude/CLAUDE.md`, then `.github/copilot-instructions.md`;
889
+ - `CLAUDE.local.md` (personal, not committed) is loaded as well, after it.
890
+
891
+ Rules in `.claude/rules/**/*.md` at the git root are loaded after the root directory's
892
+ files. These files are appended to the system prompt, root first, under a "Repository
893
+ instructions" heading that tells the model to follow them. So the model has them before it
894
+ makes any change, without having to decide to read them. Block-level `<!-- ... -->` comments
895
+ are removed first. Each file is capped at 32 KiB and the total at 64 KiB; a file over the
896
+ limit is named, with a note to read it with `read_file`.
897
+
898
+ **Imports.** `CLAUDE.md`, `CLAUDE.local.md`, rules and imported files can pull in other files
899
+ with `@path`, as in Claude Code: relative to the importing file, `~/` allowed, up to four
900
+ levels deep, each file once. Code spans and fenced code blocks are skipped, `\ ` escapes a
901
+ space, and a path that doesn't exist is treated as a mention. `AGENTS.md` has no import
902
+ syntax, so `@` there is never expanded. **Imports in repository files may not leave the
903
+ repository**: a committed `CLAUDE.md` could otherwise send `~/.ssh/...` to the model provider.
904
+ They are skipped with a warning in the banner and `/context`, and so are rules that are
905
+ symlinks to files outside it. Set `instruction_imports_outside_project = true` to allow them.
906
+ Your own files can import from anywhere.
907
+
908
+ **Rules for some paths.** A rule with `paths` front matter loads only when it is needed:
909
+
910
+ ```markdown
911
+ ---
912
+ paths:
913
+ - "src/api/**/*.{ts,tsx}"
914
+ ---
915
+ All API endpoints must validate their input.
916
+ ```
917
+
918
+ Patterns are relative to the git root (`**` crosses directories, `*` and `?` don't, `{a,b}`
919
+ alternatives).
920
+
921
+ **Deeper directories and path rules load lazily.** Instruction files deeper than the working
922
+ directory, such as `pkg/AGENTS.md`, and rules whose `paths` match are attached to the result
923
+ of the first `read_file`, `write_file` or `edit_file` call that touches a matching path, once
924
+ each. After a compaction they are attached again the next time they apply. Files that the
925
+ `bash` tool touches don't trigger this.
926
+
927
+ Instructions are read again when a session is resumed, so edits take effect. `/context` lists
928
+ the loaded files, the rules waiting for a matching path, and anything skipped. To turn loading
929
+ off (yours and the repository's), set `project_instructions = false`, or set
930
+ `AGENTIC_NO_PROJECT_INSTRUCTIONS`.
891
931
 
892
932
  ## Skills
893
933
 
@@ -1003,9 +1043,23 @@ store.
1003
1043
  **Tools** (offered when `memory` is on): `memory_save(scope, text, evidence?)`,
1004
1044
  `memory_search(pattern, scope?)`, `memory_forget(id)`.
1005
1045
 
1006
- **Prompt.** A capped, dated index (most-recently-used first, ~3 KB) is appended to the system
1007
- prompt at session start, framed as "notes from earlier sessions; may be out of date; verify
1008
- before relying on them". The rest is reachable with `memory_search`.
1046
+ **Prompt.** A capped, dated index (most-recently-used first, ~4 KB with the guidance) is
1047
+ appended to the system prompt at session start, framed as "notes from earlier sessions; may be
1048
+ out of date; verify before relying on them". The rest is reachable with `memory_search`.
1049
+
1050
+ **What gets saved.** When saving is possible, the prompt says what is worth saving, even
1051
+ before anything has been saved (adapted from Claude Code's auto memory):
1052
+
1053
+ - **Save:** corrections you give and approaches you confirm; your preferences; decisions and
1054
+ context the code and git history don't record; where to find things outside the repository;
1055
+ setup that was costly to work out.
1056
+ - **Skip:** what the code, git history or instruction files already say, one-off debugging,
1057
+ session logs, and secrets.
1058
+
1059
+ Asking the model to remember something saves it. Asking for it to go in `AGENTS.md` or
1060
+ `CLAUDE.md` edits that file instead. Once per session, after 30 tool calls without a save,
1061
+ a reminder asks whether anything durable is worth saving (`reminders = false` turns
1062
+ reminders off).
1009
1063
 
1010
1064
  **Control and hygiene.**
1011
1065
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nanobpm/nano-coder",
3
- "version": "0.37.1",
3
+ "version": "0.38.0",
4
4
  "description": "A 6MB coding agent. Run a fleet on your laptop.",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
@@ -31,9 +31,9 @@
31
31
  "node": ">=18"
32
32
  },
33
33
  "optionalDependencies": {
34
- "@nanobpm/nano-coder-darwin-arm64": "0.37.1",
35
- "@nanobpm/nano-coder-darwin-x64": "0.37.1",
36
- "@nanobpm/nano-coder-linux-arm64": "0.37.1",
37
- "@nanobpm/nano-coder-linux-x64": "0.37.1"
34
+ "@nanobpm/nano-coder-darwin-arm64": "0.38.0",
35
+ "@nanobpm/nano-coder-darwin-x64": "0.38.0",
36
+ "@nanobpm/nano-coder-linux-arm64": "0.38.0",
37
+ "@nanobpm/nano-coder-linux-x64": "0.38.0"
38
38
  }
39
39
  }