docs: document the notte stack project commands - #45
Open
giordano-lucas wants to merge 2 commits into
Open
Conversation
notte-cli's check-skills guard requires every user-facing command to be mentioned here, and `notte stack` adds nine that were not. Covers the layout and the one discovery rule, the command surface, the typical flow, notte.toml including the metadata that deploy now applies on every run, environments, secrets, what check enforces, and the constructs the bundler rejects with the fix for each. Notes two things that are otherwise found the hard way: uv is required for these commands and supplies the Python itself, and self_healing only works for functions an agent built, since it resumes the thread that created them and a CLI deploy has none. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
| Filename | Overview |
|---|---|
| plugins/notte/skills/notte-browser/references/stack-projects.md | Adds the complete stack-project reference, but no automated check accompanies its extensive CLI command and configuration contracts. |
| plugins/notte/skills/notte-browser/references/function-management.md | Replaces manual URL downloading with concise latest-version and version-specific CLI download examples. |
| plugins/notte/skills/notte-browser/SKILL.md | Adds the function-download command to the primary Function command catalog. |
Prompt To Fix All With AI
### Issue 1
plugins/notte/skills/notte-browser/references/stack-projects.md:55-65
**Command docs lack validation**
The new command surface has no automated documentation or command-surface validation test, so later CLI changes can leave agents executing stale or unsupported syntax without CI detecting the drift.
---
For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.Reviews (1): Last reviewed commit: "docs: document the notte stack project c..." | Re-trigger Greptile
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
notte-cli's
check-skillsguard requires every user-facing command to be mentioned inplugins/notte/skills/. nottelabs/notte-cli#75 adds nine commands undernotte stack, so that PR cannot go green until this one lands — the guard reads this repository'smainbranch, not the submodule pin.What
One reference,
notte-browser/references/stack-projects.md, alongside the existingfunction-management.mdand friends.It covers when to reach for
notte stackovernotte functions— the former manages a directory of functions with shared code, the latter one function by id — plus the layout and its single discovery rule, the command surface,notte.toml, environments, secrets, whatcheckenforces, and the constructs the bundler rejects with the fix for each.Two things worth flagging
notte stackneedsuv, which also supplies the Python the runtime uses. Nothing else in the CLI does, so it is called out rather than assumed.self_healingonly works for functions an agent built. It resumes the thread that created them, and a CLI deploy has none — the API refuses it with a 400. Documented so nobody sets it and wonders why.Both are the kind of thing otherwise found by hitting them.
🤖 Generated with Claude Code