@burdenoff/microfe-vibecontrols 2026.623.3 → 2026.623.4

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 (11) hide show
  1. package/dist/components/agents/AgentForm.js +2 -2
  2. package/dist/components/agents/AgentForm.js.map +1 -1
  3. package/dist/components/shared/AgentSetupBanner.js +2 -2
  4. package/dist/components/shared/AgentSetupBanner.js.map +1 -1
  5. package/dist/components/shared/InstallTabs.js +17 -56
  6. package/dist/components/shared/InstallTabs.js.map +1 -1
  7. package/dist/pages/GettingStartedPage.js +130 -114
  8. package/dist/pages/GettingStartedPage.js.map +1 -1
  9. package/dist/translations/en.js +27 -52
  10. package/dist/translations/en.js.map +1 -1
  11. package/package.json +1 -1
package/dist/pages/GettingStartedPage.js CHANGED
@@ -10,42 +10,42 @@ import { jsx as f, jsxs as p } from "react/jsx-runtime";
10
10
  import { Tabs as m } from "@burdenoff/fe-libs/chrome";
11
11
  import { MotionItem as h, MotionList as g, MotionPage as _ } from "@burdenoff/fe-libs/shared/motion";
12
12
  //#region src/pages/GettingStartedPage.tsx
13
- var v = "https://www.npmjs.com/package/@vibecontrols/cli";
14
- function y() {
15
- let { t: y } = o(), b = r((e, t) => {
16
- let n = y(e);
13
+ var v = "https://www.npmjs.com/package/@vibecontrols/agent", y = "https://docs.vibecontrols.com/users/installing-the-agent";
14
+ function b() {
15
+ let { t: b } = o(), x = r((e, t) => {
16
+ let n = b(e);
17
17
  return n === e ? t : n;
18
- }, [y]), [x, S] = d(), C = i(() => [{
18
+ }, [b]), [S, C] = d(), w = i(() => [{
19
19
  id: "install",
20
- label: b("gettingStarted.installTab", "Install")
20
+ label: x("gettingStarted.installTab", "Install")
21
21
  }, {
22
22
  id: "cli",
23
- label: b("gettingStarted.cliTab", "CLI Reference")
24
- }], [b]), w = x.get("tab") ?? C[0].id, T = (e) => {
25
- let t = new URLSearchParams(x);
26
- e === C[0].id ? t.delete("tab") : t.set("tab", e), S(t, { replace: !0 });
27
- }, [E, D] = a("");
23
+ label: x("gettingStarted.cliTab", "CLI Reference")
24
+ }], [x]), T = S.get("tab") ?? w[0].id, E = (e) => {
25
+ let t = new URLSearchParams(S);
26
+ e === w[0].id ? t.delete("tab") : t.set("tab", e), C(t, { replace: !0 });
27
+ }, [D, O] = a("");
28
28
  return /* @__PURE__ */ p(_, {
29
29
  className: "space-y-8 px-6 lg:px-8 py-6 bg-bg-canvas min-h-screen",
30
30
  children: [
31
31
  /* @__PURE__ */ f(e, {
32
- title: b("gettingStarted.title", "Getting Started"),
33
- description: b("gettingStarted.description", "Install and configure the VibeControls Agent CLI")
32
+ title: x("gettingStarted.title", "Getting Started"),
33
+ description: x("gettingStarted.description", "Install and configure the VibeControls Agent CLI")
34
34
  }),
35
35
  /* @__PURE__ */ f("div", {
36
36
  className: "border-b border-border-subtle",
37
37
  children: /* @__PURE__ */ f(m, {
38
- items: C,
39
- activeTabId: w,
40
- onTabChange: T,
38
+ items: w,
39
+ activeTabId: T,
40
+ onTabChange: E,
41
41
  variant: "underline"
42
42
  })
43
43
  }),
44
- w === "install" && /* @__PURE__ */ p("div", {
44
+ T === "install" && /* @__PURE__ */ p("div", {
45
45
  className: "space-y-6",
46
46
  children: [
47
47
  /* @__PURE__ */ f("div", {
48
- className: "relative border border-border-subtle bg-accent-purple-subtle rounded-card p-6 sm:p-8 shadow-elevation-1",
48
+ className: "relative border border-border-subtle bg-bg-elevated rounded-card p-6 sm:p-8 shadow-elevation-1",
49
49
  children: /* @__PURE__ */ p("div", {
50
50
  className: "flex items-start gap-4",
51
51
  children: [/* @__PURE__ */ f("div", {
@@ -53,13 +53,23 @@ function y() {
53
53
  children: /* @__PURE__ */ f(s, { className: "size-6 text-accent-purple" })
54
54
  }), /* @__PURE__ */ p("div", {
55
55
  className: "flex-1",
56
- children: [/* @__PURE__ */ f("h2", {
57
- className: "text-lg sm:text-xl font-semibold text-text-primary mb-1",
58
- children: b("gettingStarted.installAgent", "Install the Agent")
59
- }), /* @__PURE__ */ f("p", {
60
- className: "text-sm text-text-secondary",
61
- children: b("gettingStarted.installAgentDesc", "Run a single command on the machine you want to manage. The recommended curl script installs bun (pinned) and the agent automatically — no other prerequisites.")
62
- })]
56
+ children: [
57
+ /* @__PURE__ */ f("h2", {
58
+ className: "text-lg sm:text-xl font-semibold text-text-primary mb-1",
59
+ children: x("gettingStarted.installAgent", "Install the Agent")
60
+ }),
61
+ /* @__PURE__ */ f("p", {
62
+ className: "text-sm text-text-secondary",
63
+ children: x("gettingStarted.installAgentDesc", "Install the agent globally with bun or npm on the machine you want to manage, then run vibe start. Bun (or Node >= 18 for npm) is the only prerequisite.")
64
+ }),
65
+ /* @__PURE__ */ p("a", {
66
+ href: y,
67
+ target: "_blank",
68
+ rel: "noopener noreferrer",
69
+ className: "mt-3 inline-flex items-center gap-1.5 text-sm text-text-link hover:text-text-linkHover hover:underline",
70
+ children: [x("gettingStarted.viewInstallDocs", "View the full install docs"), /* @__PURE__ */ f(c, { className: "size-3.5" })]
71
+ })
72
+ ]
63
73
  })]
64
74
  })
65
75
  }),
@@ -67,7 +77,7 @@ function y() {
67
77
  padding: "none",
68
78
  children: /* @__PURE__ */ p("div", {
69
79
  className: "p-5 sm:p-6",
70
- children: [/* @__PURE__ */ f(n, { pinnedAgentVersion: E || void 0 }), /* @__PURE__ */ p("div", {
80
+ children: [/* @__PURE__ */ f(n, { pinnedAgentVersion: D || void 0 }), /* @__PURE__ */ p("div", {
71
81
  className: "mt-6 pt-4 border-t border-border-subtle",
72
82
  children: [/* @__PURE__ */ p("label", {
73
83
  htmlFor: "pinned-version",
@@ -75,15 +85,15 @@ function y() {
75
85
  children: [
76
86
  /* @__PURE__ */ f(l, { className: "size-3.5" }),
77
87
  " ",
78
- b("gettingStarted.pinVersion", "Pin a specific agent version (optional)")
88
+ x("gettingStarted.pinVersion", "Pin a specific agent version (optional)")
79
89
  ]
80
90
  }), /* @__PURE__ */ f("input", {
81
91
  "aria-label": "pinned-version",
82
92
  id: "pinned-version",
83
93
  type: "text",
84
- placeholder: b("gettingStarted.pinVersionPlaceholder", "e.g. 2026.408.1 (leave blank for latest)"),
85
- value: E,
86
- onChange: (e) => D(e.target.value),
94
+ placeholder: x("gettingStarted.pinVersionPlaceholder", "e.g. 2026.408.1 (leave blank for latest)"),
95
+ value: D,
96
+ onChange: (e) => O(e.target.value),
87
97
  className: "w-full max-w-xs px-3 py-2 rounded-input border border-border-default bg-bg-elevated text-sm text-text-primary focus-visible:outline-none focus-visible:border-border-strong focus-visible:shadow-[var(--shadow-focus)]"
88
98
  })]
89
99
  })]
@@ -93,119 +103,125 @@ function y() {
93
103
  padding: "none",
94
104
  children: /* @__PURE__ */ p("div", {
95
105
  className: "p-5 sm:p-6",
96
- children: [/* @__PURE__ */ f("h3", {
97
- className: "text-base font-semibold text-text-primary mb-3",
98
- children: b("gettingStarted.nextSteps", "Next steps")
99
- }), /* @__PURE__ */ p("ol", {
100
- className: "list-decimal list-inside space-y-2 text-sm text-text-secondary",
101
- children: [
102
- /* @__PURE__ */ p("li", { children: [
103
- b("gettingStarted.nextStep1Prefix", "Start the agent:"),
104
- " ",
105
- /* @__PURE__ */ f("code", {
106
- className: "font-mono text-xs bg-bg-sunken/60 text-text-secondary px-1.5 py-0.5 rounded",
107
- children: "vibecontrols auth login"
108
- }),
109
- " ",
110
- b("gettingStarted.nextStep1Suffix", "to authenticate the CLI before running workspace commands.")
111
- ] }),
112
- /* @__PURE__ */ p("li", { children: [
113
- b("gettingStarted.nextStep2Prefix", "Select a workspace and inspect agents:"),
114
- " ",
115
- /* @__PURE__ */ f("code", {
116
- className: "font-mono text-xs bg-bg-sunken/60 text-text-secondary px-1.5 py-0.5 rounded",
117
- children: "vibecontrols workspace set <id>"
118
- }),
119
- " ",
120
- b("gettingStarted.nextStep2And", "then"),
121
- " ",
122
- /* @__PURE__ */ f("code", {
123
- className: "font-mono text-xs bg-bg-sunken/60 text-text-secondary px-1.5 py-0.5 rounded",
124
- children: "vibecontrols agents list"
125
- }),
126
- "."
127
- ] }),
128
- /* @__PURE__ */ p("li", { children: [
129
- b("gettingStarted.nextStep3Prefix", "In this UI, go to"),
130
- " ",
131
- /* @__PURE__ */ p("strong", { children: [
132
- b("gettingStarted.targetsAndAgents", "Targets & Agents"),
133
- " →",
106
+ children: [
107
+ /* @__PURE__ */ f("h3", {
108
+ className: "text-base font-semibold text-text-primary mb-3",
109
+ children: x("gettingStarted.nextSteps", "Next steps")
110
+ }),
111
+ /* @__PURE__ */ p("ol", {
112
+ className: "list-decimal list-inside space-y-2 text-sm text-text-secondary",
113
+ children: [
114
+ /* @__PURE__ */ p("li", { children: [
115
+ x("gettingStarted.nextStep1Prefix", "Start the agent:"),
134
116
  " ",
135
- b("gettingStarted.addAgent", "Add Agent")
117
+ /* @__PURE__ */ f("code", {
118
+ className: "font-mono text-xs bg-bg-sunken/60 text-text-secondary px-1.5 py-0.5 rounded",
119
+ children: "vibe start"
120
+ }),
121
+ " ",
122
+ x("gettingStarted.nextStep1Suffix", "— on first run it establishes a Cloudflare tunnel, generates an agentApiKey, and waits in pre-config mode for the platform.")
136
123
  ] }),
137
- b("gettingStarted.nextStep3Suffix", ", pick or create a target, and paste the URL and key from step 2.")
138
- ] })
139
- ]
140
- })]
124
+ /* @__PURE__ */ p("li", { children: [
125
+ x("gettingStarted.nextStep2Prefix", "In this UI, go to"),
126
+ " ",
127
+ /* @__PURE__ */ p("strong", { children: [
128
+ x("gettingStarted.targetsAndAgents", "Targets & Agents"),
129
+ " →",
130
+ " ",
131
+ x("gettingStarted.addAgent", "Add Agent")
132
+ ] }),
133
+ x("gettingStarted.nextStep2Suffix", ", create or pick a target, and paste the tunnel URL and agentApiKey that vibe start printed. The platform then pushes OAuth credentials automatically and the agent activates.")
134
+ ] }),
135
+ /* @__PURE__ */ p("li", { children: [
136
+ x("gettingStarted.nextStep3Prefix", "Run it as a background service:"),
137
+ " ",
138
+ /* @__PURE__ */ f("code", {
139
+ className: "font-mono text-xs bg-bg-sunken/60 text-text-secondary px-1.5 py-0.5 rounded",
140
+ children: "vibe autostart install"
141
+ }),
142
+ " ",
143
+ x("gettingStarted.nextStep3Suffix", "(remove later with"),
144
+ " ",
145
+ /* @__PURE__ */ f("code", {
146
+ className: "font-mono text-xs bg-bg-sunken/60 text-text-secondary px-1.5 py-0.5 rounded",
147
+ children: "vibe autostart uninstall"
148
+ }),
149
+ x("gettingStarted.nextStep3End", ").")
150
+ ] }),
151
+ /* @__PURE__ */ p("li", { children: [
152
+ x("gettingStarted.nextStep4Prefix", "Verify it is running with"),
153
+ " ",
154
+ /* @__PURE__ */ f("code", {
155
+ className: "font-mono text-xs bg-bg-sunken/60 text-text-secondary px-1.5 py-0.5 rounded",
156
+ children: "vibe health"
157
+ }),
158
+ " ",
159
+ x("gettingStarted.nextStep4And", "and"),
160
+ " ",
161
+ /* @__PURE__ */ f("code", {
162
+ className: "font-mono text-xs bg-bg-sunken/60 text-text-secondary px-1.5 py-0.5 rounded",
163
+ children: "vibe status"
164
+ }),
165
+ "."
166
+ ] })
167
+ ]
168
+ }),
169
+ /* @__PURE__ */ p("a", {
170
+ href: y,
171
+ target: "_blank",
172
+ rel: "noopener noreferrer",
173
+ className: "mt-4 inline-flex items-center gap-1.5 text-sm text-text-link hover:text-text-linkHover hover:underline",
174
+ children: [x("gettingStarted.viewInstallDocs", "View the full install docs"), /* @__PURE__ */ f(c, { className: "size-3.5" })]
175
+ })
176
+ ]
141
177
  })
142
178
  })
143
179
  ]
144
180
  }),
145
- w === "cli" && /* @__PURE__ */ f(t, {
181
+ T === "cli" && /* @__PURE__ */ f(t, {
146
182
  padding: "none",
147
183
  children: /* @__PURE__ */ p("div", {
148
184
  className: "p-5 sm:p-6",
149
185
  children: [
150
186
  /* @__PURE__ */ p("h3", {
151
187
  className: "text-base font-semibold text-text-primary mb-4 flex items-center gap-2",
152
- children: [/* @__PURE__ */ f(u, { className: "size-5 text-accent-purple" }), b("gettingStarted.cliQuickRef", "CLI Quick Reference")]
188
+ children: [/* @__PURE__ */ f(u, { className: "size-5 text-accent-purple" }), x("gettingStarted.cliQuickRef", "CLI Quick Reference")]
153
189
  }),
154
190
  /* @__PURE__ */ f(g, {
155
191
  stagger: .04,
156
192
  className: "space-y-2",
157
193
  children: [
158
194
  {
159
- cmd: "vibecontrols auth login",
160
- desc: b("gettingStarted.cmdAuthLogin", "Sign in with OAuth2 Device Code")
161
- },
162
- {
163
- cmd: "vibecontrols auth whoami",
164
- desc: b("gettingStarted.cmdAuthWhoami", "Show the active signed-in identity")
165
- },
166
- {
167
- cmd: "vibecontrols workspace set <id>",
168
- desc: b("gettingStarted.cmdWorkspaceSet", "Choose the workspace context")
169
- },
170
- {
171
- cmd: "vibecontrols vibes list",
172
- desc: b("gettingStarted.cmdVibesList", "List VibeControls vibes")
173
- },
174
- {
175
- cmd: "vibecontrols agents list",
176
- desc: b("gettingStarted.cmdAgentsList", "List registered agents")
177
- },
178
- {
179
- cmd: "vibecontrols sessions list",
180
- desc: b("gettingStarted.cmdSessionsList", "List workspace sessions")
195
+ cmd: "vibe start",
196
+ desc: x("gettingStarted.cmdVibeStart", "First run: auto-detects deps, picks a port (default 3005), establishes a Cloudflare tunnel, generates an agentApiKey, then waits for the platform")
181
197
  },
182
198
  {
183
- cmd: "vibecontrols tags create --key bug --label Bug",
184
- desc: b("gettingStarted.cmdTagsCreate", "Create a workspace tag")
199
+ cmd: "vibe start --profile <name>",
200
+ desc: x("gettingStarted.cmdVibeStartProfile", "Run a named profile (e.g. alpha, default) for multiple agent instances")
185
201
  },
186
202
  {
187
- cmd: "vibecontrols rbac check <user> read project",
188
- desc: b("gettingStarted.cmdRbacCheck", "Check RBAC access")
203
+ cmd: "vibe setup",
204
+ desc: x("gettingStarted.cmdVibeSetup", "Install missing dependencies (tmux, ttyd, cloudflared)")
189
205
  },
190
206
  {
191
- cmd: "vibecontrols products feature-flags list",
192
- desc: b("gettingStarted.cmdFeatureFlagsList", "List product feature flags")
207
+ cmd: "vibe health",
208
+ desc: x("gettingStarted.cmdVibeHealth", "Run an HTTP health check on the agent")
193
209
  },
194
210
  {
195
- cmd: "vibecontrols devportal apps list --status PUBLISHED",
196
- desc: b("gettingStarted.cmdDevportalApps", "List published Developer Portal apps")
211
+ cmd: "vibe status",
212
+ desc: x("gettingStarted.cmdVibeStatus", "Show all running agent instances")
197
213
  },
198
214
  {
199
- cmd: "vibecontrols billing subscriptions list",
200
- desc: b("gettingStarted.cmdBillingSubscriptions", "List billing subscriptions")
215
+ cmd: "vibe autostart install",
216
+ desc: x("gettingStarted.cmdVibeAutostartInstall", "Run the agent as a background service (daemonize)")
201
217
  },
202
218
  {
203
- cmd: "vibecontrols health check",
204
- desc: b("gettingStarted.cmdHealthCheck", "Run platform health checks")
219
+ cmd: "vibe autostart uninstall",
220
+ desc: x("gettingStarted.cmdVibeAutostartUninstall", "Remove the background service")
205
221
  },
206
222
  {
207
- cmd: "vibecontrols auth logout",
208
- desc: b("gettingStarted.cmdAuthLogout", "Sign out of the CLI")
223
+ cmd: "vibecontrols agents list --active",
224
+ desc: x("gettingStarted.cmdAgentsListActive", "Platform CLI — see the connected agent on the backend")
209
225
  }
210
226
  ].map((e) => /* @__PURE__ */ p(h, {
211
227
  className: "flex flex-col sm:flex-row sm:items-center gap-1 sm:gap-3 px-3 py-2 rounded-button hover:bg-bg-sunken transition-colors",
@@ -226,13 +242,13 @@ function y() {
226
242
  rel: "noopener noreferrer",
227
243
  className: "inline-flex items-center gap-2 px-3 py-1.5 text-xs border border-border-default text-text-secondary rounded-button hover:bg-bg-sunken hover:border-border-strong transition-colors",
228
244
  children: [
229
- b("gettingStarted.cliNpmPackage", "CLI npm package"),
245
+ x("gettingStarted.agentNpmPackage", "Agent npm package"),
230
246
  " ",
231
247
  /* @__PURE__ */ f(c, { className: "size-3" })
232
248
  ]
233
249
  }), /* @__PURE__ */ f("span", {
234
250
  className: "text-xs text-text-muted",
235
- children: b("gettingStarted.cliNpmLatest", "@vibecontrols/cli (latest)")
251
+ children: x("gettingStarted.agentNpmLatest", "@vibecontrols/agent (latest)")
236
252
  })]
237
253
  })
238
254
  ]
@@ -242,6 +258,6 @@ function y() {
242
258
  });
243
259
  }
244
260
  //#endregion
245
- export { y as GettingStartedPage };
261
+ export { b as GettingStartedPage };
246
262
 
247
263
  //# sourceMappingURL=GettingStartedPage.js.map
package/dist/pages/GettingStartedPage.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"GettingStartedPage.js","names":[],"sources":["../../src/pages/GettingStartedPage.tsx"],"sourcesContent":["import { useCallback, useMemo, useState } from 'react';\nimport { useSearchParams } from 'react-router-dom';\nimport { Terminal, ExternalLink, Download, Info } from 'lucide-react';\nimport { PageHeader, Card, InstallTabs } from '@/components/shared';\nimport { MotionPage, MotionList, MotionItem } from '@burdenoff/fe-libs/shared/motion';\nimport { Tabs, type TabItem } from '@burdenoff/fe-libs/chrome';\nimport { useI18n } from '@burdenoff/fe-libs/shared/providers/shell/I18nProvider';\n\nconst CLI_NPM_URL = 'https://www.npmjs.com/package/@vibecontrols/cli';\n\n/**\n * Getting Started page — a tabbed guide to installing and using the\n * VibeControls Agent CLI. Two top-level tabs:\n *\n * • Install — shows curl / npm commands for Linux, macOS, Windows via\n * the shared `InstallTabs` component.\n * • CLI Reference — a compact reference of the most common commands.\n *\n * Bun is the only machine prerequisite — the curl install script installs\n * it automatically at a pinned version (v1.3.10). OAuth2 is always enabled\n * in the gateway so no manual configuration is needed.\n */\nexport function GettingStartedPage() {\n const { t } = useI18n();\n const tr = useCallback(\n (key: string, fallback: string): string => {\n const value = t(key);\n return value === key ? fallback : value;\n },\n [t]\n );\n const [params, setParams] = useSearchParams();\n const tabs: TabItem[] = useMemo(\n () => [\n { id: 'install', label: tr('gettingStarted.installTab', 'Install') },\n { id: 'cli', label: tr('gettingStarted.cliTab', 'CLI Reference') },\n ],\n [tr]\n );\n const activeId = params.get('tab') ?? tabs[0].id;\n const handleTabChange = (id: string) => {\n const next = new URLSearchParams(params);\n if (id === tabs[0].id) next.delete('tab');\n else next.set('tab', id);\n setParams(next, { replace: true });\n };\n\n const [pinnedVersion, setPinnedVersion] = useState('');\n\n return (\n <MotionPage className=\"space-y-8 px-6 lg:px-8 py-6 bg-bg-canvas min-h-screen\">\n <PageHeader\n title={tr('gettingStarted.title', 'Getting Started')}\n description={tr(\n 'gettingStarted.description',\n 'Install and configure the VibeControls Agent CLI'\n )}\n />\n\n <div className=\"border-b border-border-subtle\">\n <Tabs\n items={tabs}\n activeTabId={activeId}\n onTabChange={handleTabChange}\n variant=\"underline\"\n />\n </div>\n\n {activeId === 'install' && (\n <div className=\"space-y-6\">\n {/* Hero */}\n <div className=\"relative border border-border-subtle bg-accent-purple-subtle rounded-card p-6 sm:p-8 shadow-elevation-1\">\n <div className=\"flex items-start gap-4\">\n <div className=\"flex-shrink-0 size-12 rounded-xl bg-[var(--color-accent-soft)] flex items-center justify-center\">\n <Download className=\"size-6 text-accent-purple\" />\n </div>\n <div className=\"flex-1\">\n <h2 className=\"text-lg sm:text-xl font-semibold text-text-primary mb-1\">\n {tr('gettingStarted.installAgent', 'Install the Agent')}\n </h2>\n <p className=\"text-sm text-text-secondary\">\n {tr(\n 'gettingStarted.installAgentDesc',\n 'Run a single command on the machine you want to manage. The recommended curl script installs bun (pinned) and the agent automatically — no other prerequisites.'\n )}\n </p>\n </div>\n </div>\n </div>\n\n {/* Install tabs */}\n <Card padding=\"none\">\n <div className=\"p-5 sm:p-6\">\n <InstallTabs pinnedAgentVersion={pinnedVersion || undefined} />\n\n <div className=\"mt-6 pt-4 border-t border-border-subtle\">\n <label\n htmlFor=\"pinned-version\"\n className=\"text-xs font-medium text-text-secondary flex items-center gap-1.5 mb-1.5\"\n >\n <Info className=\"size-3.5\" />{' '}\n {tr('gettingStarted.pinVersion', 'Pin a specific agent version (optional)')}\n </label>\n <input\n aria-label=\"pinned-version\"\n id=\"pinned-version\"\n type=\"text\"\n placeholder={tr(\n 'gettingStarted.pinVersionPlaceholder',\n 'e.g. 2026.408.1 (leave blank for latest)'\n )}\n value={pinnedVersion}\n onChange={(e) => setPinnedVersion(e.target.value)}\n className=\"w-full max-w-xs px-3 py-2 rounded-input border border-border-default bg-bg-elevated text-sm text-text-primary focus-visible:outline-none focus-visible:border-border-strong focus-visible:shadow-[var(--shadow-focus)]\"\n />\n </div>\n </div>\n </Card>\n\n {/* Next steps */}\n <Card padding=\"none\">\n <div className=\"p-5 sm:p-6\">\n <h3 className=\"text-base font-semibold text-text-primary mb-3\">\n {tr('gettingStarted.nextSteps', 'Next steps')}\n </h3>\n <ol className=\"list-decimal list-inside space-y-2 text-sm text-text-secondary\">\n <li>\n {tr('gettingStarted.nextStep1Prefix', 'Start the agent:')}{' '}\n <code className=\"font-mono text-xs bg-bg-sunken/60 text-text-secondary px-1.5 py-0.5 rounded\">\n vibecontrols auth login\n </code>{' '}\n {tr(\n 'gettingStarted.nextStep1Suffix',\n 'to authenticate the CLI before running workspace commands.'\n )}\n </li>\n <li>\n {tr('gettingStarted.nextStep2Prefix', 'Select a workspace and inspect agents:')}{' '}\n <code className=\"font-mono text-xs bg-bg-sunken/60 text-text-secondary px-1.5 py-0.5 rounded\">\n vibecontrols workspace set &lt;id&gt;\n </code>{' '}\n {tr('gettingStarted.nextStep2And', 'then')}{' '}\n <code className=\"font-mono text-xs bg-bg-sunken/60 text-text-secondary px-1.5 py-0.5 rounded\">\n vibecontrols agents list\n </code>\n .\n </li>\n <li>\n {tr('gettingStarted.nextStep3Prefix', 'In this UI, go to')}{' '}\n <strong>\n {tr('gettingStarted.targetsAndAgents', 'Targets & Agents')} →{' '}\n {tr('gettingStarted.addAgent', 'Add Agent')}\n </strong>\n {tr(\n 'gettingStarted.nextStep3Suffix',\n ', pick or create a target, and paste the URL and key from step 2.'\n )}\n </li>\n </ol>\n </div>\n </Card>\n </div>\n )}\n\n {activeId === 'cli' && (\n <Card padding=\"none\">\n <div className=\"p-5 sm:p-6\">\n <h3 className=\"text-base font-semibold text-text-primary mb-4 flex items-center gap-2\">\n <Terminal className=\"size-5 text-accent-purple\" />\n {tr('gettingStarted.cliQuickRef', 'CLI Quick Reference')}\n </h3>\n <MotionList stagger={0.04} className=\"space-y-2\">\n {[\n {\n cmd: 'vibecontrols auth login',\n desc: tr('gettingStarted.cmdAuthLogin', 'Sign in with OAuth2 Device Code'),\n },\n {\n cmd: 'vibecontrols auth whoami',\n desc: tr('gettingStarted.cmdAuthWhoami', 'Show the active signed-in identity'),\n },\n {\n cmd: 'vibecontrols workspace set <id>',\n desc: tr('gettingStarted.cmdWorkspaceSet', 'Choose the workspace context'),\n },\n {\n cmd: 'vibecontrols vibes list',\n desc: tr('gettingStarted.cmdVibesList', 'List VibeControls vibes'),\n },\n {\n cmd: 'vibecontrols agents list',\n desc: tr('gettingStarted.cmdAgentsList', 'List registered agents'),\n },\n {\n cmd: 'vibecontrols sessions list',\n desc: tr('gettingStarted.cmdSessionsList', 'List workspace sessions'),\n },\n {\n cmd: 'vibecontrols tags create --key bug --label Bug',\n desc: tr('gettingStarted.cmdTagsCreate', 'Create a workspace tag'),\n },\n {\n cmd: 'vibecontrols rbac check <user> read project',\n desc: tr('gettingStarted.cmdRbacCheck', 'Check RBAC access'),\n },\n {\n cmd: 'vibecontrols products feature-flags list',\n desc: tr('gettingStarted.cmdFeatureFlagsList', 'List product feature flags'),\n },\n {\n cmd: 'vibecontrols devportal apps list --status PUBLISHED',\n desc: tr(\n 'gettingStarted.cmdDevportalApps',\n 'List published Developer Portal apps'\n ),\n },\n {\n cmd: 'vibecontrols billing subscriptions list',\n desc: tr('gettingStarted.cmdBillingSubscriptions', 'List billing subscriptions'),\n },\n {\n cmd: 'vibecontrols health check',\n desc: tr('gettingStarted.cmdHealthCheck', 'Run platform health checks'),\n },\n {\n cmd: 'vibecontrols auth logout',\n desc: tr('gettingStarted.cmdAuthLogout', 'Sign out of the CLI'),\n },\n ].map((item) => (\n <MotionItem\n key={item.cmd}\n className=\"flex flex-col sm:flex-row sm:items-center gap-1 sm:gap-3 px-3 py-2 rounded-button hover:bg-bg-sunken transition-colors\"\n >\n <code className=\"text-xs font-mono text-text-primary sm:w-72 flex-shrink-0\">\n $ {item.cmd}\n </code>\n <span className=\"text-xs text-text-muted\">{item.desc}</span>\n </MotionItem>\n ))}\n </MotionList>\n <div className=\"mt-4 pt-4 border-t border-border-subtle flex flex-wrap items-center gap-3\">\n <a\n href={CLI_NPM_URL}\n target=\"_blank\"\n rel=\"noopener noreferrer\"\n className=\"inline-flex items-center gap-2 px-3 py-1.5 text-xs border border-border-default text-text-secondary rounded-button hover:bg-bg-sunken hover:border-border-strong transition-colors\"\n >\n {tr('gettingStarted.cliNpmPackage', 'CLI npm package')}{' '}\n <ExternalLink className=\"size-3\" />\n </a>\n <span className=\"text-xs text-text-muted\">\n {tr('gettingStarted.cliNpmLatest', '@vibecontrols/cli (latest)')}\n </span>\n </div>\n </div>\n </Card>\n )}\n </MotionPage>\n );\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"GettingStartedPage.js","names":[],"sources":["../../src/pages/GettingStartedPage.tsx"],"sourcesContent":["import { useCallback, useMemo, useState } from 'react';\nimport { useSearchParams } from 'react-router-dom';\nimport { Terminal, ExternalLink, Download, Info } from 'lucide-react';\nimport { PageHeader, Card, InstallTabs } from '@/components/shared';\nimport { MotionPage, MotionList, MotionItem } from '@burdenoff/fe-libs/shared/motion';\nimport { Tabs, type TabItem } from '@burdenoff/fe-libs/chrome';\nimport { useI18n } from '@burdenoff/fe-libs/shared/providers/shell/I18nProvider';\n\nconst AGENT_NPM_URL = 'https://www.npmjs.com/package/@vibecontrols/agent';\nconst INSTALL_DOCS_URL = 'https://docs.vibecontrols.com/users/installing-the-agent';\n\n/**\n * Getting Started page — a tabbed guide to installing and running the\n * VibeControls Agent. Two top-level tabs:\n *\n * • Install — shows the global bun / npm install commands via the shared\n * `InstallTabs` component, plus the real connect-and-run flow.\n * • CLI Reference — a compact reference of the agent's `vibe` commands.\n *\n * Bun (or Node >= 18 for npm) is the only machine prerequisite. On first run\n * `vibe start` sets up a Cloudflare tunnel, generates an agentApiKey, and\n * waits for the platform to push OAuth credentials once the agent is\n * connected here.\n *\n * Official docs: https://docs.vibecontrols.com/users/installing-the-agent\n */\nexport function GettingStartedPage() {\n const { t } = useI18n();\n const tr = useCallback(\n (key: string, fallback: string): string => {\n const value = t(key);\n return value === key ? fallback : value;\n },\n [t]\n );\n const [params, setParams] = useSearchParams();\n const tabs: TabItem[] = useMemo(\n () => [\n { id: 'install', label: tr('gettingStarted.installTab', 'Install') },\n { id: 'cli', label: tr('gettingStarted.cliTab', 'CLI Reference') },\n ],\n [tr]\n );\n const activeId = params.get('tab') ?? tabs[0].id;\n const handleTabChange = (id: string) => {\n const next = new URLSearchParams(params);\n if (id === tabs[0].id) next.delete('tab');\n else next.set('tab', id);\n setParams(next, { replace: true });\n };\n\n const [pinnedVersion, setPinnedVersion] = useState('');\n\n return (\n <MotionPage className=\"space-y-8 px-6 lg:px-8 py-6 bg-bg-canvas min-h-screen\">\n <PageHeader\n title={tr('gettingStarted.title', 'Getting Started')}\n description={tr(\n 'gettingStarted.description',\n 'Install and configure the VibeControls Agent CLI'\n )}\n />\n\n <div className=\"border-b border-border-subtle\">\n <Tabs\n items={tabs}\n activeTabId={activeId}\n onTabChange={handleTabChange}\n variant=\"underline\"\n />\n </div>\n\n {activeId === 'install' && (\n <div className=\"space-y-6\">\n {/* Hero */}\n <div className=\"relative border border-border-subtle bg-bg-elevated rounded-card p-6 sm:p-8 shadow-elevation-1\">\n <div className=\"flex items-start gap-4\">\n <div className=\"flex-shrink-0 size-12 rounded-xl bg-[var(--color-accent-soft)] flex items-center justify-center\">\n <Download className=\"size-6 text-accent-purple\" />\n </div>\n <div className=\"flex-1\">\n <h2 className=\"text-lg sm:text-xl font-semibold text-text-primary mb-1\">\n {tr('gettingStarted.installAgent', 'Install the Agent')}\n </h2>\n <p className=\"text-sm text-text-secondary\">\n {tr(\n 'gettingStarted.installAgentDesc',\n 'Install the agent globally with bun or npm on the machine you want to manage, then run vibe start. Bun (or Node >= 18 for npm) is the only prerequisite.'\n )}\n </p>\n <a\n href={INSTALL_DOCS_URL}\n target=\"_blank\"\n rel=\"noopener noreferrer\"\n className=\"mt-3 inline-flex items-center gap-1.5 text-sm text-text-link hover:text-text-linkHover hover:underline\"\n >\n {tr('gettingStarted.viewInstallDocs', 'View the full install docs')}\n <ExternalLink className=\"size-3.5\" />\n </a>\n </div>\n </div>\n </div>\n\n {/* Install tabs */}\n <Card padding=\"none\">\n <div className=\"p-5 sm:p-6\">\n <InstallTabs pinnedAgentVersion={pinnedVersion || undefined} />\n\n <div className=\"mt-6 pt-4 border-t border-border-subtle\">\n <label\n htmlFor=\"pinned-version\"\n className=\"text-xs font-medium text-text-secondary flex items-center gap-1.5 mb-1.5\"\n >\n <Info className=\"size-3.5\" />{' '}\n {tr('gettingStarted.pinVersion', 'Pin a specific agent version (optional)')}\n </label>\n <input\n aria-label=\"pinned-version\"\n id=\"pinned-version\"\n type=\"text\"\n placeholder={tr(\n 'gettingStarted.pinVersionPlaceholder',\n 'e.g. 2026.408.1 (leave blank for latest)'\n )}\n value={pinnedVersion}\n onChange={(e) => setPinnedVersion(e.target.value)}\n className=\"w-full max-w-xs px-3 py-2 rounded-input border border-border-default bg-bg-elevated text-sm text-text-primary focus-visible:outline-none focus-visible:border-border-strong focus-visible:shadow-[var(--shadow-focus)]\"\n />\n </div>\n </div>\n </Card>\n\n {/* Next steps */}\n <Card padding=\"none\">\n <div className=\"p-5 sm:p-6\">\n <h3 className=\"text-base font-semibold text-text-primary mb-3\">\n {tr('gettingStarted.nextSteps', 'Next steps')}\n </h3>\n <ol className=\"list-decimal list-inside space-y-2 text-sm text-text-secondary\">\n <li>\n {tr('gettingStarted.nextStep1Prefix', 'Start the agent:')}{' '}\n <code className=\"font-mono text-xs bg-bg-sunken/60 text-text-secondary px-1.5 py-0.5 rounded\">\n vibe start\n </code>{' '}\n {tr(\n 'gettingStarted.nextStep1Suffix',\n '— on first run it establishes a Cloudflare tunnel, generates an agentApiKey, and waits in pre-config mode for the platform.'\n )}\n </li>\n <li>\n {tr('gettingStarted.nextStep2Prefix', 'In this UI, go to')}{' '}\n <strong>\n {tr('gettingStarted.targetsAndAgents', 'Targets & Agents')} →{' '}\n {tr('gettingStarted.addAgent', 'Add Agent')}\n </strong>\n {tr(\n 'gettingStarted.nextStep2Suffix',\n ', create or pick a target, and paste the tunnel URL and agentApiKey that vibe start printed. The platform then pushes OAuth credentials automatically and the agent activates.'\n )}\n </li>\n <li>\n {tr('gettingStarted.nextStep3Prefix', 'Run it as a background service:')}{' '}\n <code className=\"font-mono text-xs bg-bg-sunken/60 text-text-secondary px-1.5 py-0.5 rounded\">\n vibe autostart install\n </code>{' '}\n {tr('gettingStarted.nextStep3Suffix', '(remove later with')}{' '}\n <code className=\"font-mono text-xs bg-bg-sunken/60 text-text-secondary px-1.5 py-0.5 rounded\">\n vibe autostart uninstall\n </code>\n {tr('gettingStarted.nextStep3End', ').')}\n </li>\n <li>\n {tr('gettingStarted.nextStep4Prefix', 'Verify it is running with')}{' '}\n <code className=\"font-mono text-xs bg-bg-sunken/60 text-text-secondary px-1.5 py-0.5 rounded\">\n vibe health\n </code>{' '}\n {tr('gettingStarted.nextStep4And', 'and')}{' '}\n <code className=\"font-mono text-xs bg-bg-sunken/60 text-text-secondary px-1.5 py-0.5 rounded\">\n vibe status\n </code>\n .\n </li>\n </ol>\n <a\n href={INSTALL_DOCS_URL}\n target=\"_blank\"\n rel=\"noopener noreferrer\"\n className=\"mt-4 inline-flex items-center gap-1.5 text-sm text-text-link hover:text-text-linkHover hover:underline\"\n >\n {tr('gettingStarted.viewInstallDocs', 'View the full install docs')}\n <ExternalLink className=\"size-3.5\" />\n </a>\n </div>\n </Card>\n </div>\n )}\n\n {activeId === 'cli' && (\n <Card padding=\"none\">\n <div className=\"p-5 sm:p-6\">\n <h3 className=\"text-base font-semibold text-text-primary mb-4 flex items-center gap-2\">\n <Terminal className=\"size-5 text-accent-purple\" />\n {tr('gettingStarted.cliQuickRef', 'CLI Quick Reference')}\n </h3>\n <MotionList stagger={0.04} className=\"space-y-2\">\n {[\n {\n cmd: 'vibe start',\n desc: tr(\n 'gettingStarted.cmdVibeStart',\n 'First run: auto-detects deps, picks a port (default 3005), establishes a Cloudflare tunnel, generates an agentApiKey, then waits for the platform'\n ),\n },\n {\n cmd: 'vibe start --profile <name>',\n desc: tr(\n 'gettingStarted.cmdVibeStartProfile',\n 'Run a named profile (e.g. alpha, default) for multiple agent instances'\n ),\n },\n {\n cmd: 'vibe setup',\n desc: tr(\n 'gettingStarted.cmdVibeSetup',\n 'Install missing dependencies (tmux, ttyd, cloudflared)'\n ),\n },\n {\n cmd: 'vibe health',\n desc: tr('gettingStarted.cmdVibeHealth', 'Run an HTTP health check on the agent'),\n },\n {\n cmd: 'vibe status',\n desc: tr('gettingStarted.cmdVibeStatus', 'Show all running agent instances'),\n },\n {\n cmd: 'vibe autostart install',\n desc: tr(\n 'gettingStarted.cmdVibeAutostartInstall',\n 'Run the agent as a background service (daemonize)'\n ),\n },\n {\n cmd: 'vibe autostart uninstall',\n desc: tr(\n 'gettingStarted.cmdVibeAutostartUninstall',\n 'Remove the background service'\n ),\n },\n {\n cmd: 'vibecontrols agents list --active',\n desc: tr(\n 'gettingStarted.cmdAgentsListActive',\n 'Platform CLI — see the connected agent on the backend'\n ),\n },\n ].map((item) => (\n <MotionItem\n key={item.cmd}\n className=\"flex flex-col sm:flex-row sm:items-center gap-1 sm:gap-3 px-3 py-2 rounded-button hover:bg-bg-sunken transition-colors\"\n >\n <code className=\"text-xs font-mono text-text-primary sm:w-72 flex-shrink-0\">\n $ {item.cmd}\n </code>\n <span className=\"text-xs text-text-muted\">{item.desc}</span>\n </MotionItem>\n ))}\n </MotionList>\n <div className=\"mt-4 pt-4 border-t border-border-subtle flex flex-wrap items-center gap-3\">\n <a\n href={AGENT_NPM_URL}\n target=\"_blank\"\n rel=\"noopener noreferrer\"\n className=\"inline-flex items-center gap-2 px-3 py-1.5 text-xs border border-border-default text-text-secondary rounded-button hover:bg-bg-sunken hover:border-border-strong transition-colors\"\n >\n {tr('gettingStarted.agentNpmPackage', 'Agent npm package')}{' '}\n <ExternalLink className=\"size-3\" />\n </a>\n <span className=\"text-xs text-text-muted\">\n {tr('gettingStarted.agentNpmLatest', '@vibecontrols/agent (latest)')}\n </span>\n </div>\n </div>\n </Card>\n )}\n </MotionPage>\n );\n}\n"],"mappings":"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"}
package/dist/translations/en.js CHANGED
@@ -306,7 +306,7 @@ var e = {
306
306
  inlineTargetFailed: "Failed to create target. Please try again.",
307
307
  installHint: "After running vibe start, copy the printed tunnel URL and API key into the fields above.",
308
308
  installInstructions: "Agent Install Instructions",
309
- installStep1: "1. Install the agent CLI",
309
+ installStep1: "1. Install the agent globally",
310
310
  installStep2: "2. Start the agent",
311
311
  installStep3: "3. Get the API key",
312
312
  installStep4: "4. Start the tunnel",
@@ -712,58 +712,37 @@ var e = {
712
712
  },
713
713
  gettingStarted: {
714
714
  addAgent: "Add Agent",
715
- cliNpmLatest: "@vibecontrols/cli (latest)",
716
- cliNpmPackage: "CLI npm package",
715
+ agentNpmLatest: "@vibecontrols/agent (latest)",
716
+ agentNpmPackage: "Agent npm package",
717
717
  cliQuickRef: "CLI Quick Reference",
718
718
  cliTab: "CLI Reference",
719
- cmdAgentsList: "List registered agents",
720
- cmdAiPrompts: "List prompt templates",
721
- cmdAuthLogin: "Sign in with OAuth2 Device Code",
722
- cmdAuthLogout: "Sign out of the CLI",
723
- cmdAuthWhoami: "Show the active signed-in identity",
724
- cmdAutostartInstall: "Auto-start on reboot",
725
- cmdAutostartStatus: "Check autostart status",
726
- cmdBillingSubscriptions: "List billing subscriptions",
727
- cmdConfig: "Show all config",
728
- cmdDevportalApps: "List published Developer Portal apps",
729
- cmdFeatureFlagsList: "List product feature flags",
730
- cmdHealth: "Health check",
731
- cmdHealthCheck: "Run platform health checks",
732
- cmdInfo: "Version & system info",
733
- cmdKey: "Show API key",
734
- cmdLogs: "Follow agent logs",
735
- cmdPluginCreate: "Scaffold a new plugin",
736
- cmdPluginList: "List installed plugins",
737
- cmdRbacCheck: "Check RBAC access",
738
- cmdSessionCreate: "Create a session",
739
- cmdSessionList: "List sessions",
740
- cmdSessionsList: "List workspace sessions",
741
- cmdStatus: "Show agent status",
742
- cmdStop: "Stop the agent",
743
- cmdTagsCreate: "Create a workspace tag",
744
- cmdTunnelAgent: "Show tunnel status",
745
- cmdTunnelList: "List all tunnels",
746
- cmdTunnelStart: "Expose port 8080",
747
- cmdUrl: "Show active URL (tunnel or local)",
748
- cmdVibesList: "List VibeControls vibes",
749
- cmdWorkspaceSet: "Choose the workspace context",
750
- description: "Install and configure the VibeControls Agent CLI",
719
+ cmdAgentsListActive: "Platform CLI — see the connected agent on the backend",
720
+ cmdVibeAutostartInstall: "Run the agent as a background service (daemonize)",
721
+ cmdVibeAutostartUninstall: "Remove the background service",
722
+ cmdVibeHealth: "Run an HTTP health check on the agent",
723
+ cmdVibeSetup: "Install missing dependencies (tmux, ttyd, cloudflared)",
724
+ cmdVibeStart: "First run: auto-detects deps, picks a port (default 3005), establishes a Cloudflare tunnel, generates an agentApiKey, then waits for the platform",
725
+ cmdVibeStartProfile: "Run a named profile (e.g. alpha, default) for multiple agent instances",
726
+ cmdVibeStatus: "Show all running agent instances",
727
+ description: "Install and run the VibeControls Agent",
751
728
  installAgent: "Install the Agent",
752
- installAgentDesc: "Run a single command on the machine you want to manage. The recommended curl script installs bun (pinned) and the agent automatically — no other prerequisites.",
729
+ installAgentDesc: "Install the agent globally with bun or npm on the machine you want to manage, then run vibe start. Bun (or Node >= 18 for npm) is the only prerequisite.",
753
730
  installTab: "Install",
754
731
  nextStep1Prefix: "Start the agent:",
755
- nextStep1Suffix: "to authenticate the CLI before running workspace commands.",
756
- nextStep2And: "and",
757
- nextStep2Prefix: "Grab your tunnel URL and API key:",
758
- nextStep3Prefix: "In this UI, go to",
759
- nextStep3Suffix: ", pick or create a target, and paste the URL and key from step 2.",
732
+ nextStep1Suffix: "— on first run it establishes a Cloudflare tunnel, generates an agentApiKey, and waits in pre-config mode for the platform.",
733
+ nextStep2Prefix: "In this UI, go to",
734
+ nextStep2Suffix: ", create or pick a target, and paste the tunnel URL and agentApiKey that vibe start printed. The platform then pushes OAuth credentials automatically and the agent activates.",
735
+ nextStep3End: ").",
736
+ nextStep3Prefix: "Run it as a background service:",
737
+ nextStep3Suffix: "(remove later with",
738
+ nextStep4And: "and",
739
+ nextStep4Prefix: "Verify it is running with",
760
740
  nextSteps: "Next steps",
761
- npmLatest: "@vibecontrols/agent (latest)",
762
- npmPackage: "npm package",
763
741
  pinVersion: "Pin a specific agent version (optional)",
764
742
  pinVersionPlaceholder: "e.g. 2026.408.1 (leave blank for latest)",
765
743
  targetsAndAgents: "Targets & Agents",
766
- title: "Getting Started"
744
+ title: "Getting Started",
745
+ viewInstallDocs: "View the full install docs"
767
746
  },
768
747
  gitops: {
769
748
  addProvider: "Add Provider",
@@ -2615,7 +2594,7 @@ var e = {
2615
2594
  shared: {
2616
2595
  agentSetupBanner: {
2617
2596
  clickToCopy: "Click to copy",
2618
- description: "Install the CLI on any machine you want to manage. The only prerequisite is bun — the curl script installs it for you.",
2597
+ description: "Install the agent globally on any machine you want to manage. Bun (or Node >= 18 for npm) is the only prerequisite.",
2619
2598
  dismiss: "Dismiss",
2620
2599
  installPrompt: "Install the VibeControls Agent CLI to get started",
2621
2600
  npmPackage: "npm package",
@@ -2658,15 +2637,11 @@ var e = {
2658
2637
  tooltip: "Ask the assistant to explain"
2659
2638
  },
2660
2639
  installTabs: {
2640
+ bunDescription: "Bun is the platform default and the only prerequisite. You can pin a specific release with @<version> (defaults to the latest).",
2641
+ bunRecommended: "Bun (Recommended)",
2661
2642
  clickToCopy: "Click to copy",
2662
- curlDescription: "The script installs bun (pinned, v1.3.10) then installs @vibecontrols/agent and core plugins. Only bun is required on your machine — no other prerequisites. The trailing “&& hash -r” refreshes your shell so “vibe” works immediately (using fish? drop it — fish auto-rehashes).",
2663
- curlRecommended: "Curl (Recommended)",
2664
- linux: "Linux",
2665
- macos: "macOS",
2666
2643
  npm: "NPM",
2667
- npmDescription: "Requires Node.js >= 18. You can also pass @<version> to pin a specific release.",
2668
- viewInstallScript: "View the install script",
2669
- windows: "Windows"
2644
+ npmDescription: "Requires Node.js >= 18. You can pin a specific release with @<version> (defaults to the latest)."
2670
2645
  },
2671
2646
  loadingState: { loading: "Loading..." },
2672
2647
  notificationToast: { moreNotifications: "more notification(s)" },