@pellux/goodvibes-agent 0.1.106 → 0.1.107

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to GoodVibes Agent will be recorded here.
 
+## 0.1.107 - Unreleased
+
+- Add `goodvibes-agent launch` and `goodvibes-agent start` as explicit aliases for starting the Agent TUI.
+- Open the Agent operator workspace automatically on normal TUI launch after first-run setup has been shown.
+- Document the Bun global install path with `goodvibes-agent launch` as the first interactive smoke.
+
 ## 0.1.106 - 2026-06-01
 
 - b67a2fe Polish Agent setup entrypoint

package/README.md

@@ -14,6 +14,7 @@ Install the public alpha package with Bun:
 ```sh
 bun add -g --trust @pellux/goodvibes-agent
 goodvibes-agent --help
+goodvibes-agent launch
 goodvibes-agent status
 goodvibes-agent profiles templates
 goodvibes-agent personas list
@@ -31,6 +32,8 @@ export PATH="$(bun pm bin -g):$PATH"
 goodvibes-agent --help
 ```
 
+`goodvibes-agent` and `goodvibes-agent launch` both start the interactive Agent TUI. On a fresh Agent home, the TUI opens Agent setup first.
+
 `--trust` lets Bun run the package lifecycle scripts required by the shipped SDK and parser dependencies during global install. A healthy install should report no pending lifecycle scripts:
 
 ```sh
@@ -62,7 +65,7 @@ bun run package:install-check
 bun run publish:check
 ```
 
-Inside the Agent TUI, use `/agent`, `/home`, or `/operator` to open the operator workspace. It is the Agent-first fullscreen workspace for setup, status, knowledge, local memory/skills, work-plan/approval review, automation observability, and explicit build delegation to GoodVibes TUI.
+After setup has been shown once, the Agent TUI opens directly into the operator workspace. You can also reopen it with `/agent`, `/home`, or `/operator`. It is the Agent-first fullscreen workspace for setup, status, knowledge, local memory/skills, work-plan/approval review, automation observability, and explicit build delegation to GoodVibes TUI.
 
 Inside the workspace, use `/agent-profile guide` to author custom profile starters without leaving the Agent TUI. The guided flow lists starters, exports starter JSON, imports edited local starters, and creates isolated Agent profiles from them.
 

package/docs/getting-started.md

@@ -15,6 +15,7 @@ Agent does not launch the runtime for you.
 ```sh
 bun add -g --trust @pellux/goodvibes-agent
 goodvibes-agent --help
+goodvibes-agent launch
 goodvibes-agent status
 goodvibes-agent personas list
 goodvibes-agent skills list
@@ -52,7 +53,9 @@ bun run dev
 
 `bun run dev` starts the Agent TUI. The same entrypoint backs the installed `goodvibes-agent` command.
 
-Once the TUI opens, run `/agent`, `/home`, or `/operator` to open the Agent operator workspace. That fullscreen workspace is the current front door for setup/config, knowledge status, local memory and skills, read-only work/approval/automation views, and explicit GoodVibes TUI build delegation.
+`goodvibes-agent` and `goodvibes-agent launch` both start the interactive Agent TUI. On a fresh Agent home, the TUI opens Agent setup first.
+
+After setup has been shown once, the TUI opens directly into the Agent operator workspace. You can also reopen it with `/agent`, `/home`, or `/operator`. That fullscreen workspace is the current front door for setup/config, knowledge status, local memory and skills, read-only work/approval/automation views, and explicit GoodVibes TUI build delegation.
 
 Use `/agent-profile guide` inside that workspace to walk through starter-profile authoring. It lists built-in and local starters, exports a JSON starter for editing, imports the edited starter back into this Agent home, and creates isolated profiles from the result.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-agent",
-  "version": "0.1.106",
+  "version": "0.1.107",
   "private": false,
   "description": "GoodVibes personal operator assistant TUI with a proactive Agent product brain, isolated Agent Knowledge, local profiles, routines, skills, personas, and explicit build delegation.",
   "type": "module",

package/src/cli/completion.ts

@@ -1,5 +1,7 @@
 const COMMANDS = [
   'tui',
+  'launch',
+  'start',
   'run',
   'exec',
   'onboarding',

package/src/cli/help.ts

@@ -29,7 +29,7 @@ export function renderGoodVibesHelp(binary = 'goodvibes-agent'): string {
     `       ${binary} [OPTIONS] <COMMAND> [ARGS]`,
     '',
     'Commands:',
-    '  tui [path]                 Start the interactive Agent terminal UI (default)',
+    '  tui|launch [path]          Start the interactive Agent terminal UI (default)',
     '  run|exec [prompt]          Run non-interactively with text/json/stream-json output',
     '  status                     Print config, provider, auth, and setup posture',
     '  doctor                     Print status plus setup warnings',
@@ -81,6 +81,7 @@ export function renderGoodVibesHelp(binary = 'goodvibes-agent'): string {
     '',
     'Examples:',
     `  ${binary}`,
+    `  ${binary} launch`,
     `  ${binary} --no-alt-screen`,
     `  ${binary} --cd ~/work/project --model openai:gpt-5.2`,
     `  ${binary} setup`,
@@ -119,9 +120,9 @@ type CommandHelp = {
 
 const COMMAND_HELP: Record<string, CommandHelp> = {
   tui: {
-    usage: ['tui [path]', '[prompt]'],
+    usage: ['tui [path]', 'launch [path]', '[prompt]'],
     summary: 'Start the interactive Agent terminal UI. A prompt starts Agent with that prompt seeded.',
-    examples: ['', 'tui ~/work/project', '"summarize current tasks"'],
+    examples: ['', 'launch', 'tui ~/work/project', '"summarize current tasks"'],
   },
   run: {
     usage: ['run [prompt] [--output text|json|stream-json]', 'exec [prompt]'],

package/src/cli/parser.ts

@@ -8,6 +8,8 @@ import type {
 const COMMAND_ALIASES: Readonly<Record<string, GoodVibesCliCommand>> = {
   tui: 'tui',
   app: 'tui',
+  launch: 'tui',
+  start: 'tui',
   run: 'run',
   exec: 'run',
   e: 'run',

package/src/cli/tui-startup.ts

@@ -100,6 +100,7 @@ export function applyInitialTuiCliState(options: {
 }): void {
   const { cli, input, commandRegistry, commandContext, shellPaths, render } = options;
   const globalOnboardingMarker = readOnboardingCheckMarker(shellPaths, 'user');
+  const seededPrompt = cli.flags.prompt ?? (cli.rawCommand === undefined && cli.positionals.length > 0 ? cli.positionals.join(' ') : undefined);
   if (cli.command === 'onboarding') {
     input.openOnboardingWizard({ mode: 'edit', reset: true });
   } else if (cli.command === 'sessions' && cli.commandArgs[0] === 'resume') {
@@ -109,9 +110,10 @@ export function applyInitialTuiCliState(options: {
     }
   } else if (!globalOnboardingMarker.exists) {
     input.openOnboardingWizard({ mode: 'new', reset: true });
+  } else if (cli.command === 'tui' && seededPrompt === undefined) {
+    input.openAgentWorkspace(commandContext);
   }
 
-  const seededPrompt = cli.flags.prompt ?? (cli.rawCommand === undefined && cli.positionals.length > 0 ? cli.positionals.join(' ') : undefined);
   if (seededPrompt) {
     input.prompt = seededPrompt;
     input.cursorPos = seededPrompt.length;

package/src/version.ts

@@ -6,7 +6,7 @@ import { join } from 'node:path';
 // The prebuild script updates the fallback value before compilation.
 // Uses import.meta.dir (Bun) to locate package.json relative to this file,
 // which is correct regardless of the process working directory.
-let _version = '0.1.106';
+let _version = '0.1.107';
 let _sdkVersion = '0.33.35';
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8')) as {