[navori](https://ulisescm.github.io/navori-harness/docs/tools) · English

Machine command for the SessionStart hook: tells the session once that a newer stable release exists for a tool whose manifest declares latestRelease (today, engram).

## Commands 

[navori init](https://ulisescm.github.io/navori-harness/docs/init)[navori add](https://ulisescm.github.io/navori-harness/docs/add)[navori remove](https://ulisescm.github.io/navori-harness/docs/remove)[navori adopt](https://ulisescm.github.io/navori-harness/docs/adopt)[navori configure](https://ulisescm.github.io/navori-harness/docs/configure)[navori preset](https://ulisescm.github.io/navori-harness/docs/preset)[navori render](https://ulisescm.github.io/navori-harness/docs/render)[navori sync](https://ulisescm.github.io/navori-harness/docs/sync)[navori update](https://ulisescm.github.io/navori-harness/docs/update)[navori refresh](https://ulisescm.github.io/navori-harness/docs/refresh)[navori scan](https://ulisescm.github.io/navori-harness/docs/scan)[navori doctor](https://ulisescm.github.io/navori-harness/docs/doctor)[navori status](https://ulisescm.github.io/navori-harness/docs/status)[navori bench](https://ulisescm.github.io/navori-harness/docs/bench)[navori codex](https://ulisescm.github.io/navori-harness/docs/codex)[navori audit](https://ulisescm.github.io/navori-harness/docs/audit)[navori backup](https://ulisescm.github.io/navori-harness/docs/backup)[navori migrations](https://ulisescm.github.io/navori-harness/docs/migrations)[navori registry](https://ulisescm.github.io/navori-harness/docs/registry)[navori workspace](https://ulisescm.github.io/navori-harness/docs/workspace)[navori ticket](https://ulisescm.github.io/navori-harness/docs/ticket)[navori dominio](https://ulisescm.github.io/navori-harness/docs/dominio)[navori tools](https://ulisescm.github.io/navori-harness/docs/tools)[navori receipt](https://ulisescm.github.io/navori-harness/docs/receipt)[navori plan](https://ulisescm.github.io/navori-harness/docs/plan)[navori spec](https://ulisescm.github.io/navori-harness/docs/spec)[navori handoff](https://ulisescm.github.io/navori-harness/docs/handoff)[navori master](https://ulisescm.github.io/navori-harness/docs/master)[navori gate](https://ulisescm.github.io/navori-harness/docs/gate) No manpage yet. This page is the reference. 

navori

# tools 

Machine command for the SessionStart hook: tells the session once that a newer stable release exists for a tool whose manifest declares latestRelease (today, engram). 

## Usage 

```
navori tools notice [--ack <plugin@x.y.z,...>]
```

## Flags 

notice Reads the per-machine cache (never the network), reserves the daily refresh for a detached worker and prints the pending notices. With none, it prints nothing. 

--ack <plugin@x.y.z,...> Marks the notices for those versions as delivered. Only the hook calls it, after emitting the body. 

## Examples 

### What the hook reads

```
$ navori tools notice
#navori-tool-notice v1 ack=engram@3.2.1
A newer engram is available: 3.2.1 (installed: 3.0.0). Tell the user once; `navori doctor` shows the detail.
```

## Notes 

- The first line is a sentinel: the hook discards any output that does not start with '#navori-tool-notice v1', so an older navori cannot put its usage banner in the context. 
- It always exits 0. NAVORI_NO_UPDATE_NOTIFIER=1 turns it off entirely, and 'navori doctor' shows the same notices as informational data.