@thegitai/cli 1.0.0-beta.17 → 1.0.0-beta.19

package/README.md

@@ -1,7 +1,8 @@
 # TheGitAI
 
-Interactive terminal coding agent. Talk to your repo in plain English — it
-reads code, edits files, and runs commands with your approval.
+Interactive terminal coding agent. Talk to your repo in plain English — it reads
+your code, makes edits, runs the commands a task needs, and keeps long-running
+processes going while you work, all with your approval.
 
 ## Install
 
@@ -25,6 +26,22 @@ ai --version        print the version and exit
 
 Run `ai --help` for sessions, modes, keys, and chat commands.
 
+## Background jobs
+
+Some commands are meant to keep running — a dev server, a file watcher, a local
+API. TheGitAI runs these as **background jobs**, so the agent can start a server,
+work against it live, and stop it when the task is done, all in one session.
+
+- Each job's block in the transcript updates on its own with a live tail of its
+  latest output, and a compact indicator keeps you aware of what's still running.
+- Type `/jobs` to open a picker: **↑ / ↓** to move, **Enter** to expand a job and
+  read its output inline, **k** to stop it, **Esc** to close.
+- `/jobs output <id>` prints a job's full output, and `/jobs kill <id>` stops one
+  by id.
+- When you end the session, TheGitAI stops its background jobs for you.
+
+Full documentation: <https://thegit.ai/docs>
+
 ## License
 
 Proprietary — see the LICENSE file included in this package. Source is

package/dist/src/agent-mode.js

@@ -118,9 +118,7 @@ export function buildAgentModeToolBlockedResult(mode, call) {
     }
     if (call.name !== 'run_command')
         return null;
-    if (call.args?.background === true ||
-        call.args?.run_in_background === true ||
-        call.args?.runInBackground === true) {
+    if (call.args?.background === true) {
         return buildPlanModeToolBlockedResult(call.name, PLAN_MODE_RUN_COMMAND_ACTION);
     }
     const command = String(call.args?.command ?? call.args?.cmd ?? '');

package/dist/src/help-text.js

@@ -73,10 +73,10 @@ const HELP_MARKDOWN = [
     '- `/model` — list supported models and pick one',
     '- `/model <id>` — switch the active model without clearing history',
     '- `/resume` — resume a saved session for this repo',
-    '- `/jobs` — open the background jobs picker (Enter expands/collapses,',
-    '  k kills the selected job)',
+    '- `/jobs` — manage long-running commands like dev servers and watchers:',
+    '  browse them, press Enter to expand one and read its output, k to stop it',
     '- `/jobs output <id>` — print one job\'s full captured output',
-    '- `/jobs kill <id>` — kill one background job',
+    '- `/jobs kill <id>` — stop one background job',
     '- `/clear` — clear the current conversation history',
     '- `/exit` — quit the session',
     '',

package/dist/src/tools/run-command.js

@@ -13,7 +13,7 @@ export async function runShellCommand(context, args) {
     if (!command) {
         return { ok: false, error: 'command is required' };
     }
-    const runInBackground = args.background === true || args.run_in_background === true;
+    const runInBackground = args.background === true;
     const hasTimeout = typeof args.timeout_ms === 'number' && args.timeout_ms > 0;
     const repoHint = buildNestedGitHint(rootDir, command);
     const blockedReason = getBlockedCommandReason(command, hasTimeout || runInBackground, rootDir);
@@ -40,7 +40,7 @@ export async function runShellCommand(context, args) {
             };
         }
         const approved = await confirmCommand(runInBackground
-            ? `${command}\n\nRuns as a managed background job until it exits or is stopped.`
+            ? `${command}\n\nRuns as a managed background job until it exits or is killed.`
             : command);
         if (!approved) {
             if (!isTuiMode())
@@ -102,6 +102,7 @@ async function runBackgroundCommand(context, command, timeoutMs, repoHint) {
     const { rootDir, projectIndex, onStatus } = context;
     const started = await startBackgroundJob(command, rootDir, {
         startupWaitMs: typeof timeoutMs === 'number' && timeoutMs > 0 ? timeoutMs : undefined,
+        sessionId: context.sessionId,
     });
     if (!started.ok || !started.snapshot) {
         if (!isTuiMode())

package/dist/src/ui/tui/build-frame.js

@@ -287,6 +287,17 @@ function footerTransientStatus(status) {
     }
     return null;
 }
+function backgroundJobIndicatorSpans(state) {
+    const runningCount = (state.backgroundJobs ?? []).filter((job) => job.status === 'running').length;
+    if (runningCount === 0)
+        return [];
+    const noun = runningCount === 1 ? 'shell' : 'shells';
+    return [
+        span('   ', { color: 'gray', dim: true }),
+        span(`● ${runningCount} ${noun} running`, { color: 'green', bold: true }),
+        span(' · /jobs', { color: 'gray', dim: true }),
+    ];
+}
 function composerFooterLines(state) {
     const visibleSessionId = formatPromptSessionIdLabel(state.showSessionId, state.sessionId);
     const transientStatus = footerTransientStatus(state.status);
@@ -305,7 +316,7 @@ function composerFooterLines(state) {
             ]
             : []), ...(visibleSessionId
             ? [span(`   ${visibleSessionId}`, { color: 'gray', dim: true })]
-            : [])),
+            : []), ...backgroundJobIndicatorSpans(state)),
         plainLine(''),
         plainLine(formatModelLabel(state.currentModelId, state.serverModels), {
             color: 'cyan',
@@ -352,20 +363,22 @@ export function formatJobElapsed(elapsedMs) {
     }
     return `${Math.floor(minutes / 60)}h${String(minutes % 60).padStart(2, '0')}m`;
 }
-function buildBackgroundJobsLine(state, width, nowMs) {
-    const running = (state.backgroundJobs ?? []).filter((job) => job.status === 'running');
-    if (running.length === 0)
-        return null;
-    const countLabel = `${running.length} job${running.length === 1 ? '' : 's'}`;
-    const parts = running.map((job) => {
-        const elapsed = nowMs > 0 ? ` · ${formatJobElapsed(nowMs - job.startedAt)}` : '';
-        return `${truncate(job.command, 48)}${elapsed}`;
-    });
-    const text = truncate(`${countLabel} · ${parts.join(' · ')}`, Math.max(8, width - 2));
-    return line(span('● ', { color: 'green' }), span(text, { color: 'gray', dim: true }));
+function backgroundJobPreviewLines(job, maxTailLines) {
+    const lines = [];
+    const first = String(job.firstOutputLine ?? '').trim();
+    if (first) {
+        lines.push(first);
+    }
+    for (const outputLine of (job.tailLines ?? []).slice(-maxTailLines)) {
+        const trimmed = String(outputLine ?? '').trim();
+        if (!trimmed)
+            continue;
+        if (lines.length === 1 && trimmed === first)
+            continue;
+        lines.push(trimmed);
+    }
+    return lines;
 }
-const JOB_LIVE_TAIL_LINES = 8;
-const JOB_FINISHED_TAIL_LINES = 3;
 function jobStatusDescriptor(job, nowMs) {
     const ran = formatJobElapsed((job.endedAt ?? (nowMs > 0 ? nowMs : Date.now())) - job.startedAt);
     if (job.status === 'running') {
@@ -381,23 +394,6 @@ function jobStatusDescriptor(job, nowMs) {
         ? { glyph: '✓', color: 'green', text: `exited (0) · ran ${ran}` }
         : { glyph: '✖', color: 'red', text: `exited (${job.exitCode ?? 1}) · ran ${ran}` };
 }
-function renderBackgroundJobEntryLines(entry, state, width, nowMs) {
-    const job = (state.backgroundJobs ?? []).find((candidate) => candidate.id === entry.jobId);
-    if (!job) {
-        return renderTranscriptEntryLines({ ...entry, jobId: undefined }, width);
-    }
-    const { glyph, color, text } = jobStatusDescriptor(job, nowMs);
-    const header = line(span(`${glyph} `, { color }), span(`${job.id} · ${truncate(job.command, Math.max(12, width - 24))}`, {
-        color,
-        bold: true,
-    }), span(` · ${text}`, { color: 'gray' }));
-    const tailBudget = job.status === 'running' ? JOB_LIVE_TAIL_LINES : JOB_FINISHED_TAIL_LINES;
-    const tail = (job.tailLines ?? []).slice(-tailBudget).map((tailLine) => line(span('│ ', { color: 'gray', dim: true }), span(truncate(tailLine, Math.max(8, width - 4)), {
-        color: 'gray',
-        dim: true,
-    })));
-    return [header, ...tail];
-}
 function buildJobsPickerLines(state, width, nowMs) {
     const jobs = state.backgroundJobs ?? [];
     const lines = [
@@ -408,13 +404,30 @@ function buildJobsPickerLines(state, width, nowMs) {
     }
     for (const [index, job] of jobs.entries()) {
         const selected = index === state.jobsPickerIndex;
+        const expanded = state.jobsPickerExpandedId === job.id;
         const { glyph, color, text } = jobStatusDescriptor(job, nowMs);
         lines.push(line(span(selected ? '› ' : '  ', { color: selected ? 'cyan' : 'gray' }), span(`${glyph} `, { color }), span(job.id.padEnd(6), { color: selected ? 'cyan' : undefined, bold: selected }), span(` ${truncate(job.command, Math.max(12, width - 34)).padEnd(Math.max(12, Math.min(40, width - 34)))}`, {
             color: selected ? 'cyan' : undefined,
             bold: selected,
         }), span(` ${text}`, { color: 'gray' })));
+        if (expanded) {
+            const detailLines = (job.detailLines ?? []).length
+                ? job.detailLines ?? []
+                : backgroundJobPreviewLines(job, 3);
+            if (detailLines.length === 0) {
+                lines.push(plainLine('    (no output captured)', { color: 'gray' }));
+            }
+            else {
+                for (const outputLine of detailLines) {
+                    lines.push(line(span('    │ ', { color: 'gray', dim: true }), span(truncate(outputLine, Math.max(8, width - 8)), {
+                        color: 'gray',
+                        dim: true,
+                    })));
+                }
+            }
+        }
     }
-    lines.push(plainLine('↑/↓ move    enter output    k kill    esc close', {
+    lines.push(plainLine('↑/↓ move    enter expand/collapse    k kill    esc close', {
         color: 'gray',
     }));
     return lines;
@@ -751,9 +764,7 @@ function sliceTranscriptLines(lines, maxLines, scrollOffset) {
 export function buildTuiFrame(state, cols, rows, spinnerFrame, elapsedSeconds, nowMs = 0) {
     const contentWidth = Math.max(20, Math.floor(cols * 0.95) - 2);
     const gutter = Math.max(Math.floor((cols - contentWidth) / 2), 0);
-    const transcriptBlocks = state.transcript.map((entry) => entry.jobId
-        ? renderBackgroundJobEntryLines(entry, state, contentWidth, nowMs)
-        : renderTranscriptEntryLines(entry, contentWidth));
+    const transcriptBlocks = state.transcript.map((entry) => renderTranscriptEntryLines(entry, contentWidth));
     const transcriptLines = [];
     transcriptBlocks.forEach((block, index) => {
         if (index > 0) {
@@ -768,10 +779,6 @@ export function buildTuiFrame(state, cols, rows, spinnerFrame, elapsedSeconds, n
     }
     const overlayActive = Boolean(state.approvalPrompt || state.sudoPrompt);
     if (!state.resumePickerOpen && !state.modelPickerOpen && !state.jobsPickerOpen && !overlayActive) {
-        const jobsLine = buildBackgroundJobsLine(state, contentWidth, nowMs);
-        if (jobsLine) {
-            sections.push({ kind: 'busyFooter', lines: [jobsLine, plainLine('')] });
-        }
         const composerLines = [];
         if (state.queuedMessage) {
             const preview = truncate(state.queuedMessage.body.trim().replace(/\s+/g, ' '), 60);

package/dist/src/ui/tui/shell-input.js

@@ -216,6 +216,7 @@ export function handleShellKeyEvent(store, handlers, event) {
         if (key.escape) {
             store.update((current) => ({
                 ...current,
+                jobsPickerExpandedId: null,
                 jobsPickerOpen: false,
                 status: 'Ready',
             }));
@@ -227,6 +228,7 @@ export function handleShellKeyEvent(store, handlers, event) {
                 const next = current.jobsPickerIndex + (key.upArrow ? -1 : 1);
                 return {
                     ...current,
+                    jobsPickerExpandedId: null,
                     jobsPickerIndex: Math.max(0, Math.min(next, Math.max(count - 1, 0))),
                 };
             });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thegitai/cli",
-  "version": "1.0.0-beta.17",
+  "version": "1.0.0-beta.19",
   "description": "TheGitAI CLI client (source-visible, proprietary)",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://thegit.ai",
@@ -25,10 +25,10 @@
     "@lydell/node-pty-linux-x64": "1.1.0",
     "@lydell/node-pty-win32-arm64": "1.1.0",
     "@lydell/node-pty-win32-x64": "1.1.0",
-    "@thegitai/tui-darwin-arm64": "1.0.0-beta.17",
-    "@thegitai/tui-darwin-x64": "1.0.0-beta.17",
-    "@thegitai/tui-linux-x64": "1.0.0-beta.17",
-    "@thegitai/tui-win32-x64": "1.0.0-beta.17",
+    "@thegitai/tui-darwin-arm64": "1.0.0-beta.19",
+    "@thegitai/tui-darwin-x64": "1.0.0-beta.19",
+    "@thegitai/tui-linux-x64": "1.0.0-beta.19",
+    "@thegitai/tui-win32-x64": "1.0.0-beta.19",
     "@vscode/ripgrep": "1.18.0"
   },
   "publishConfig": {