instabox 0.5.1 → 0.5.2
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.
- package/package.json +1 -1
- package/skills/instabox/SKILL.md +19 -1
package/package.json
CHANGED
package/skills/instabox/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: instabox
|
|
3
|
-
description: Use when the user wants a cloud Linux box (instabox sandbox) from the terminal with the `instabox` CLI — create one, SSH in, run a command in it, read its files, set its timeout, or delete it. For saving or restoring a box's disks, see instabox-snapshots.
|
|
3
|
+
description: Use when the user wants a cloud Linux box (instabox sandbox) from the terminal with the `instabox` CLI — create one, SSH in, run a command in it, read its files, set its timeout, or delete it, or to report a problem with instabox itself (`instabox feedback`). For saving or restoring a box's disks, see instabox-snapshots.
|
|
4
4
|
metadata:
|
|
5
5
|
installed-by: instabox
|
|
6
6
|
---
|
|
@@ -78,6 +78,24 @@ instabox create --name tenant --no-vault # a box for someone else: never gets th
|
|
|
78
78
|
|
|
79
79
|
To move the repo the user is working in (with its worktrees, uncommitted work and agent conversations) onto a new box and install its dependencies there, follow the `instabox-move-repo` skill.
|
|
80
80
|
|
|
81
|
+
## When instabox itself gets in your way (feedback)
|
|
82
|
+
|
|
83
|
+
If instabox is at fault — a command breaks the contract its help or this skill states, the skill does not match what really happens, a capability is missing, or the CLI is confusing — report it, then carry on with the user's task using a workaround. Never block on the report, and never report problems in the code the user is building.
|
|
84
|
+
|
|
85
|
+
```sh
|
|
86
|
+
instabox feedback --json --type bug --component cli --area exec \
|
|
87
|
+
--title "exec --timeout 600 stops the command at 60s" \
|
|
88
|
+
--detail "instabox exec work --timeout 600 -- make test was killed after 60 seconds" \
|
|
89
|
+
--command "instabox exec work --timeout 600 -- make test" \
|
|
90
|
+
--expected "the skill says exec accepts up to 600 seconds" --doc "skills/instabox/SKILL.md" \
|
|
91
|
+
--workaround "ran it over instabox ssh instead"
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
- `--type`: `bug` when something does not work as its help or the docs say (when instructions did not match reality, also give `--doc`, `--expected` and `--workaround`), `feature-request` when what you need is not supported, `friction` when it works but is confusing or awkward, `other` otherwise.
|
|
95
|
+
- `--component`: `cli`, `api`, `sandbox` (the box itself, its templates or tools), `dashboard`, `skills`, `docs` or `other`. `--severity blocker|major|minor` (default `minor`); `--sandbox NAME` names the box involved.
|
|
96
|
+
- Emails, keys, tokens, home paths and public IPv4 addresses are redacted before sending, but do not paste secrets into it. The report carries the signed-in account (its user ID, and its login unless that is an email address), so the team can follow up.
|
|
97
|
+
- A failed or unconfirmed submission prints a warning and exits 0: do not retry. File one report per problem, not one per attempt.
|
|
98
|
+
|
|
81
99
|
## Habits
|
|
82
100
|
|
|
83
101
|
- Forgotten boxes pause themselves. Give a box a `--timeout` when it must stop at a deadline, or `--timeout D --on-timeout kill` when it should be deleted then.
|