instabox 0.8.90 → 0.8.91
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/README.md +2 -2
- package/bin/instabox.mjs +17 -13
- package/cli/SHA256SUMS +6 -6
- package/cli/instabox-darwin-amd64 +0 -0
- package/cli/instabox-darwin-arm64 +0 -0
- package/cli/instabox-linux-amd64 +0 -0
- package/cli/instabox-linux-arm64 +0 -0
- package/cli/instabox-windows-amd64.exe +0 -0
- package/cli/instabox-windows-arm64.exe +0 -0
- package/lib/skills.mjs +13 -3
- package/package.json +1 -1
- package/skills/instabox/SKILL.md +2 -2
package/README.md
CHANGED
|
@@ -6,7 +6,7 @@ npx instabox@latest sh # the same, then start a new box and SSH into it
|
|
|
6
6
|
npx instabox@latest skills install -y # only the agent skills: no sign-in, no network
|
|
7
7
|
```
|
|
8
8
|
|
|
9
|
-
`npx instabox@latest` signs you in to instabox with a device code (first run only: open the page it prints on any device and enter the code; it opens the page for you where there is a browser, never with `--no-browser`), installs the `instabox` CLI already signed in or updates an out-of-date one (skip with `--no-cli`), installs or updates the agent skills from [`../skills`](../skills) in `~/.claude/skills` and `~/.
|
|
9
|
+
`npx instabox@latest` signs you in to instabox with a device code (first run only: open the page it prints on any device and enter the code; it opens the page for you where there is a browser, never with `--no-browser`), installs the `instabox` CLI already signed in or updates an out-of-date one (skip with `--no-cli`), installs or updates the agent skills from [`../skills`](../skills) in `~/.claude/skills`, `~/.agents/skills` and `~/.gemini/config/skills` (skip with `--no-skills`), and prints the next steps. It does not touch your boxes.
|
|
10
10
|
|
|
11
11
|
`npx instabox@latest sh` does all that, then starts a new box (`box-<hex>`) and drops you into it over SSH, no questions. Run by an agent (no terminal), it starts the box and prints `instabox ssh <box> -- <command>` instead of opening a shell. At the box limit it starts nothing and lists your boxes, to remove one (`instabox rm --yes <box>`) or open one (`instabox ssh <box>`).
|
|
12
12
|
|
|
@@ -14,7 +14,7 @@ A GitHub and a Google sign-in are separate instabox accounts, each with its own
|
|
|
14
14
|
|
|
15
15
|
Without a terminal (an agent, CI), nobody can enter a device code, so the sign-in comes from `INSTABOX_API_KEY` (an `ibk_...` key, as the CLI takes it: no browser, no device code, nothing saved), a sign-in already saved, or an agent key from `instabox login --agent`. With none of them it exits at once with status 3 and says how to go on, instead of waiting for a code nobody will enter. `--device-code` asks for the device code anyway, for an agent that relays it to a person. `-y` (`--yes`) asks nothing: no invite-code prompt.
|
|
16
16
|
|
|
17
|
-
`npx instabox@latest skills install [-y] [--claude|--codex|--cursor|--all]` installs only the agent skills, with no sign-in: Claude Code's in `~/.claude/skills`, Codex's and
|
|
17
|
+
`npx instabox@latest skills install [-y] [--claude|--codex|--cursor|--opencode|--antigravity|--all]` installs only the agent skills, with no sign-in: Claude Code's in `~/.claude/skills`, Codex's, Cursor's and OpenCode's in `~/.agents/skills` (all three read it, so one copy serves them), Antigravity's in `~/.gemini/config/skills`. With no agent named it installs for all of them, asking first at a terminal unless `-y`. An unknown flag is a usage error, status 2.
|
|
18
18
|
|
|
19
19
|
Any other command line is the instabox CLI's ([`cmd/instabox`](../cmd/instabox)): `npx instabox@latest ls` runs `instabox ls`, installing the CLI first if it is missing.
|
|
20
20
|
|
package/bin/instabox.mjs
CHANGED
|
@@ -12,7 +12,7 @@ import {
|
|
|
12
12
|
existsSync,
|
|
13
13
|
} from 'node:fs';
|
|
14
14
|
import { createInterface } from 'node:readline/promises';
|
|
15
|
-
import { tmpdir
|
|
15
|
+
import { tmpdir } from 'node:os';
|
|
16
16
|
import { join, dirname } from 'node:path';
|
|
17
17
|
import { createClient } from '../lib/api.mjs';
|
|
18
18
|
import { orderBoxes } from '../lib/boxes.mjs';
|
|
@@ -35,7 +35,7 @@ import { browserCommand, canOpenBrowser, deviceLogin } from '../lib/login.mjs';
|
|
|
35
35
|
import { makeDirPrivate, sessionArgs } from '../lib/ssh.mjs';
|
|
36
36
|
import { loadCredentials, saveCredentials } from '../lib/credentials.mjs';
|
|
37
37
|
import { agentName, track } from '../lib/telemetry.mjs';
|
|
38
|
-
import { AGENT_DIRS, describeSkills, installSkills, skillRoots } from '../lib/skills.mjs';
|
|
38
|
+
import { AGENT_DIRS, describeSkills, installSkills, showRoots, skillRoots } from '../lib/skills.mjs';
|
|
39
39
|
|
|
40
40
|
// Same variables, same order as the instabox CLI, so both talk to one server.
|
|
41
41
|
const API = (
|
|
@@ -78,7 +78,8 @@ function usage() {
|
|
|
78
78
|
${bold('instabox')}: a cloud box in seconds
|
|
79
79
|
|
|
80
80
|
npx instabox@latest sign in with a device code (first time), install the instabox
|
|
81
|
-
CLI and agent skills (~/.claude/skills, ~/.agents/skills
|
|
81
|
+
CLI and agent skills (~/.claude/skills, ~/.agents/skills,
|
|
82
|
+
~/.gemini/config/skills)
|
|
82
83
|
npx instabox@latest sh the same, then start a new box and SSH into it
|
|
83
84
|
--github, --google sign in with that provider
|
|
84
85
|
--no-browser only print the sign-in page and code; do not open a browser
|
|
@@ -86,7 +87,7 @@ function usage() {
|
|
|
86
87
|
--no-skills do not install the instabox agent skills
|
|
87
88
|
-y, --yes ask nothing (no invite-code prompt)
|
|
88
89
|
--device-code sign in with a device code even without a terminal
|
|
89
|
-
npx instabox@latest skills install [--claude|--codex|--cursor|--all] [-y]
|
|
90
|
+
npx instabox@latest skills install [--claude|--codex|--cursor|--opencode|--antigravity|--all] [-y]
|
|
90
91
|
only the agent skills; no sign-in
|
|
91
92
|
npx instabox@latest <command> run an instabox CLI command (instabox help lists them)
|
|
92
93
|
|
|
@@ -323,20 +324,23 @@ async function reportInstalls(cli) {
|
|
|
323
324
|
const cliLine = await cli;
|
|
324
325
|
if (cliLine) console.log(` ${green('✓')} ${cliLine}`);
|
|
325
326
|
if (process.argv.includes('--no-skills')) return;
|
|
326
|
-
const
|
|
327
|
-
|
|
327
|
+
const roots = skillRoots([]);
|
|
328
|
+
const skillsLine = describeSkills(installSkills(roots));
|
|
329
|
+
if (skillsLine) console.log(` ${green('✓')} ${skillsLine} ${dim(`(${showRoots(roots)})`)}`);
|
|
328
330
|
}
|
|
329
331
|
|
|
330
332
|
// `skills install`: the agent skills only. No sign-in, no network, nothing else installed.
|
|
331
333
|
const SKILLS_USAGE = `
|
|
332
|
-
usage: npx instabox@latest skills install [-y] [--claude] [--codex] [--cursor] [--all]
|
|
334
|
+
usage: npx instabox@latest skills install [-y] [--claude] [--codex] [--cursor] [--opencode] [--antigravity] [--all]
|
|
333
335
|
|
|
334
336
|
Copies the instabox agent skills into the folders your coding agents read. No sign-in needed.
|
|
335
|
-
--claude
|
|
336
|
-
--codex
|
|
337
|
-
--cursor
|
|
338
|
-
--
|
|
339
|
-
|
|
337
|
+
--claude Claude Code: ~/.claude/skills
|
|
338
|
+
--codex Codex: ~/.agents/skills
|
|
339
|
+
--cursor Cursor: ~/.agents/skills (Cursor reads it; the same copy as --codex)
|
|
340
|
+
--opencode OpenCode: ~/.agents/skills (OpenCode reads it; the same copy as --codex)
|
|
341
|
+
--antigravity Antigravity: ~/.gemini/config/skills
|
|
342
|
+
--all all of them (the default when no agent is named)
|
|
343
|
+
-y, --yes do not ask; without a terminal it never asks
|
|
340
344
|
`;
|
|
341
345
|
|
|
342
346
|
async function skillsCommand(argv) {
|
|
@@ -362,7 +366,7 @@ async function skillsCommand(argv) {
|
|
|
362
366
|
}
|
|
363
367
|
}
|
|
364
368
|
const roots = skillRoots(agents);
|
|
365
|
-
const shown = roots
|
|
369
|
+
const shown = showRoots(roots);
|
|
366
370
|
// Only a person at a terminal is asked, and only when no agent was named.
|
|
367
371
|
if (!yes && !agents.length && process.stdin.isTTY && process.stdout.isTTY) {
|
|
368
372
|
const rl = createInterface({ input: process.stdin, output: process.stdout });
|
package/cli/SHA256SUMS
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
1
|
+
7893b7794184b9d52a775102fd1a3f47ccd70e315c90333421699469a0ce1d13 instabox-darwin-amd64
|
|
2
|
+
154bbf4b53f6cebff796dc47baa517a58846e6cc335802b1076c428d73667952 instabox-darwin-arm64
|
|
3
|
+
da81d8c87f448e28fd317d5dc1d098d97c27658994e8aed03c718ad67f074b14 instabox-linux-amd64
|
|
4
|
+
346f56acab814d5ef5934886862f863874573edc4a7e7d8042071841dcfd5192 instabox-linux-arm64
|
|
5
|
+
229628b8174a4e4d3f79de1849a8a22e2b69c0126d1d08bcf5155b6ecbb5b699 instabox-windows-amd64.exe
|
|
6
|
+
2b3395f0a9ca6d7f70110fa78095b1f6c386caee639473cd6621d1dfd2ef7de5 instabox-windows-arm64.exe
|
|
Binary file
|
|
Binary file
|
package/cli/instabox-linux-amd64
CHANGED
|
Binary file
|
package/cli/instabox-linux-arm64
CHANGED
|
Binary file
|
|
Binary file
|
|
Binary file
|
package/lib/skills.mjs
CHANGED
|
@@ -7,13 +7,18 @@ import { fileURLToPath } from 'node:url';
|
|
|
7
7
|
|
|
8
8
|
export const SKILLS_SRC = join(dirname(fileURLToPath(import.meta.url)), '..', 'skills');
|
|
9
9
|
|
|
10
|
-
// Where each agent reads user-level skills. Claude Code reads ~/.claude/skills. Codex and
|
|
11
|
-
//
|
|
12
|
-
//
|
|
10
|
+
// Where each agent reads user-level skills. Claude Code reads ~/.claude/skills. Codex, Cursor and
|
|
11
|
+
// OpenCode all read ~/.agents/skills (the user-level location in their docs; OpenCode also reads
|
|
12
|
+
// ~/.claude/skills and ~/.config/opencode/skills), so one copy there serves the three; a second
|
|
13
|
+
// copy in ~/.cursor/skills or ~/.config/opencode/skills would show that agent every skill twice.
|
|
14
|
+
// Antigravity (the IDE, the CLI and the App) reads ~/.gemini/config/skills
|
|
15
|
+
// (antigravity.google/docs/skills); it does not read ~/.agents/skills.
|
|
13
16
|
export const AGENT_DIRS = {
|
|
14
17
|
claude: ['.claude', 'skills'],
|
|
15
18
|
codex: ['.agents', 'skills'],
|
|
16
19
|
cursor: ['.agents', 'skills'],
|
|
20
|
+
opencode: ['.agents', 'skills'],
|
|
21
|
+
antigravity: ['.gemini', 'config', 'skills'],
|
|
17
22
|
};
|
|
18
23
|
|
|
19
24
|
// The skill folders for the chosen agents (every agent when none is chosen), each once.
|
|
@@ -22,6 +27,11 @@ export function skillRoots(agents, home = homedir()) {
|
|
|
22
27
|
return [...new Set(names.map((a) => join(home, ...AGENT_DIRS[a])))];
|
|
23
28
|
}
|
|
24
29
|
|
|
30
|
+
// The roots as shown to the user: ~/.claude/skills, ~/.agents/skills, ...
|
|
31
|
+
export function showRoots(roots, home = homedir()) {
|
|
32
|
+
return roots.map((r) => (r.startsWith(home) ? `~${r.slice(home.length)}` : r)).join(', ');
|
|
33
|
+
}
|
|
34
|
+
|
|
25
35
|
// A skill directory's files, relative to it, sorted.
|
|
26
36
|
function skillFiles(dir, rel = '') {
|
|
27
37
|
return readdirSync(join(dir, rel), { withFileTypes: true })
|
package/package.json
CHANGED
package/skills/instabox/SKILL.md
CHANGED
|
@@ -20,7 +20,7 @@ A GitHub sign-in and a Google sign-in with the same verified email share one acc
|
|
|
20
20
|
|
|
21
21
|
`instabox update` replaces the CLI with the server's current build (it prints "already up to date" when it is); run it when a command the docs describe is missing, or when a command ends with `instabox X is outdated (latest Y): run instabox update` on stderr (a daily check; `instabox version --json` has `outdated`/`latest`; `INSTABOX_NO_UPDATE_CHECK=1` silences it). `instabox completion bash|zsh|fish|powershell` prints a shell completion script for the user's shell startup file.
|
|
22
22
|
|
|
23
|
-
For CI or an agent without a browser, use an API key instead: `export INSTABOX_API_KEY=ibk_...` (the user creates it in the dashboard: API keys in the sidebar). Never print, commit or log a key. Installing or updating these skills needs no sign-in: `npx instabox@latest skills install -y` (`--claude` for `~/.claude/skills`, `--codex` or `--
|
|
23
|
+
For CI or an agent without a browser, use an API key instead: `export INSTABOX_API_KEY=ibk_...` (the user creates it in the dashboard: API keys in the sidebar). Never print, commit or log a key. Installing or updating these skills needs no sign-in: `npx instabox@latest skills install -y` (`--claude` for `~/.claude/skills`, `--codex`, `--cursor` or `--opencode` for `~/.agents/skills`, `--antigravity` for `~/.gemini/config/skills`; none named: all).
|
|
24
24
|
|
|
25
25
|
With no key and nobody at the keyboard, sign up by yourself: `instabox login --agent` (optionally `--name 'what this agent is' --scope machines:read,machines:write --expires-in-days 30`). It prints a claim page (`https://dashboard.instabox.sh/dashboard/claim?code=XXXX-XXXX`) and the code; relay both to the user and wait. The user opens the page on any device, signs in or signs up, checks what you ask for and approves; the command then finishes on its own, stores the API key made for you in the user's account, and every later `instabox` command uses it. The code works for 24 hours. If you must do other work meanwhile, `instabox login --agent --no-wait` prints the page and code and exits, and `instabox login --agent` later resumes the same registration. Before the user approves you have no account and no credential: do not retry other commands, wait. A denial or an expired code is an error; register again only if the user asks. The user can also approve from their own terminal with `instabox claim XXXX-XXXX`.
|
|
26
26
|
|
|
@@ -191,7 +191,7 @@ To move the repo the user is working in (with its worktrees, uncommitted work an
|
|
|
191
191
|
|
|
192
192
|
## MCP clients
|
|
193
193
|
|
|
194
|
-
Keep using the CLI and this skill. If the user wants instabox as MCP tools in Claude Code, Cursor or
|
|
194
|
+
Keep using the CLI and this skill. If the user wants instabox as MCP tools in Claude Code, Cursor, Codex, OpenCode or Antigravity, `instabox mcp init claude|cursor|codex|opencode|antigravity` writes that client's config (the client then runs `instabox mcp start`, which uses this CLI's sign-in or `INSTABOX_API_KEY` and never opens a browser); `--hosted` points it at `https://api.instabox.sh/mcp` with the key read from `INSTABOX_API_KEY` (Antigravity reads no variables, so add `--inline-key` there). The user restarts the client afterwards. Details: https://instabox.sh/docs/mcp.md
|
|
195
195
|
|
|
196
196
|
## When instabox itself gets in your way (feedback)
|
|
197
197
|
|