xtralab 0.2.0 → 0.3.0

package/README.md

@@ -2,153 +2,152 @@
 
 An opinionated JupyterLab meta-package.
 
-`xtralab` bundles a curated set of JupyterLab extensions, ships its own
-JupyterLab extension with a path-first file browser and a VS Code-style git
-changes panel, and applies a quieter default workspace configuration. The
-defaults are shipped under `etc/jupyter/labconfig` and the bundled
-labextension is shipped under `share/jupyter/labextensions/xtralab`.
+Bundles a curated set of extensions, a path-first file browser, a VS Code-style
+git changes panel, an agent-focused launcher, and a quieter default workspace.
 
-The goal is to keep the package easy to inspect: most behavior comes from the
-upstream Jupyter packages, while `xtralab` defines the default environment we
-want out of the box.
+## Install
 
-## Approach
+```bash
+pip install xtralab
+```
 
-The package brings together:
+## Usage
 
-- The `ajlab` meta-package (agent-ready JupyterLab — collaboration plumbing, MCP support, command tooling, and its own quieter defaults)
-- JupyterLab 4.6+
-- Git server integration (`jupyterlab-git` — backs the bundled changes panel)
-- Quick file opening (`jupyterlab-quickopen`)
-- Cursor styling helpers (`jupyterlab-cursor-light`, `jupyterlab-cursor-theme`)
-- Day and night themes (`jupyterlab-day`, `jupyterlab-night`)
-
-These are installed as normal Python dependencies, so deployments can still
-override versions and Jupyter configuration in the usual ways.
-
-## Bundled labextension
-
-`xtralab` ships its own prebuilt labextension that contributes:
-
-- A path-first file browser in the left sidebar, built on `@pierre/trees`.
-- A VS Code-style "Source Control" panel in the left sidebar, powered by the
-  `jupyterlab-git` server REST API and `@pierre/diffs`. The bundled
-  `@jupyterlab/git` frontend is disabled automatically so the two panels do
-  not coexist.
-- An agent-focused launcher that replaces the stock JupyterLab launcher.
-  The launcher tab shows an optional initial-prompt textarea, a row of
-  agent buttons (Claude, Codex, Gemini, Copilot, Goose, OpenCode, Kiro,
-  and Mistral Vibe), and a collapsible list of changed files (each
-  clickable into the diff viewer) below them. Clicking an agent opens a
-  fresh terminal and runs the agent's CLI; if the prompt textarea is
-  non-empty, the prompt is shell-quoted and spliced into the launch line
-  for agents that accept one. Agents are filtered by a `which`-based
-  availability check at activation, so only the ones actually installed
-  on the machine show up.
-
-### Customizing the launcher
-
-The launcher reads `xtralab:launcher` settings from the JupyterLab settings
-registry. Open the Settings Editor (`Settings → Settings Editor → xtralab
-launcher`) and edit the `agents` array; xtralab merges your entries with
-the defaults by `id`.
-
-```jsonc
-{
-  "agents": [
-    // Hide an agent you never want to see, even if it's installed:
-    { "id": "kiro", "enabled": false },
+### As a JupyterLab package
 
-    // Override an agent's command — e.g. point Claude at a shell alias.
-    // `requireAvailable: false` keeps the card visible even though
-    // `which cl` returns nothing (interactive shells expand the alias).
-    { "id": "claude", "command": "cl", "requireAvailable": false },
+Run JupyterLab the usual way:
 
-    // Add a brand-new agent. `iconSvg` is optional; without it the card
-    // falls back to a generic terminal icon. `promptArgs: []` means the
-    // launcher's prompt textarea is appended as a positional argument.
-    {
-      "id": "aider",
-      "label": "Aider",
-      "command": "aider",
-      "promptArgs": []
-    }
-  ]
-}
+```bash
+jupyter lab
 ```
 
-Field reference (every field except `id` is optional):
-
-| Field              | Effect                                                                                                                                                                                                                                                                                                                                             |
-| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `id`               | Built-in id to override, or a new id to define a new card.                                                                                                                                                                                                                                                                                         |
-| `label`            | Card title.                                                                                                                                                                                                                                                                                                                                        |
-| `caption`          | Subtitle shown beneath the title.                                                                                                                                                                                                                                                                                                                  |
-| `command`          | Literal text typed into the new terminal.                                                                                                                                                                                                                                                                                                          |
-| `iconSvg`          | Inline SVG for the card icon (only needed for new agents).                                                                                                                                                                                                                                                                                         |
-| `rank`             | Sort order on the launcher; lower comes first.                                                                                                                                                                                                                                                                                                     |
-| `enabled`          | `false` hides the card from the launcher and palette.                                                                                                                                                                                                                                                                                              |
-| `requireAvailable` | `false` skips the `which` check (use for shell aliases that aren't on PATH but expand at runtime).                                                                                                                                                                                                                                                 |
-| `promptArgs`       | How to splice the launcher's optional prompt into the command. `[]` appends it as a positional argument (`<command> 'PROMPT'`); `["-i"]` or `["--prompt"]` puts it after a flag. Set to `null` to opt out — the agent button is dimmed when the prompt textarea is non-empty so a typed prompt is never silently dropped. Defaults vary per agent. |
-
-## Default settings
-
-`xtralab` ships the following JupyterLab defaults:
-
-- The announcements plugin is disabled, so JupyterLab does not prompt to fetch
-  news from the Jupyter news feed and does not check for application updates.
-- The Table of Contents, Debugger, and Notebook Tools panels are disabled so
-  they do not show up in the right sidebar by default.
-- `dockPanelPadding` is off, so the main dock area is flush with the
-  surrounding chrome.
-- The terminal `fontFamily` defaults to `MesloLGS NF, ui-monospace, monospace`
-  so Powerline / Nerd Font glyphs (used by Oh My Zsh themes such as
-  `powerlevel10k`) render correctly when the font is installed; the
-  `ui-monospace, monospace` fallback keeps things readable when it is not.
-
-The JupyterLab frontend defaults are shipped as `labconfig/*.d/00-xtralab.json`
-fragments so downstream meta-packages can add their own Lab configuration
-fragments without replacing `xtralab`'s files.
+### As a desktop app
 
-## Install
+A standalone Electron build (DMG on macOS, AppImage on Linux) ships with each
+tagged release — grab the installer for your platform from the
+[Releases page](https://github.com/jtpio/xtralab/releases/latest). Builds from
+the current `main` branch are also produced on every push as workflow
+artifacts under the repository's
+[Actions tab](https://github.com/jtpio/xtralab/actions). See
+[CONTRIBUTING.md](./CONTRIBUTING.md) for the architecture and local build
+instructions.
 
-```bash
-pip install xtralab
-```
+## What's included
 
-## Run as a desktop app
+- [`ajlab`](https://github.com/jtpio/ajlab) — agent-ready JupyterLab base
+- JupyterLab 4.6+
+- `jupyterlab-git` — backs the bundled changes panel
+- `jupyterlab-lsp` + `ty` — Python LSP via Astral's `ty` (bundled); also
+  detects `typescript-language-server` on `PATH` for JS/TS
+- `jupyterlab-quickopen`
+- `jupyterlab-cursor-light`, `jupyterlab-cursor-dark`
+- `jupyterlab-day`, `jupyterlab-night` themes
+
+The bundled labextension adds:
+
+- A path-first file browser in the left sidebar.
+- A "Source Control" panel powered by `jupyterlab-git` and `@pierre/diffs`.
+- An agent launcher with a prompt textarea, a row of agent buttons (Claude,
+  Codex, Gemini, Copilot, Goose, OpenCode, Kiro, Mistral Vibe), and a
+  collapsible list of changed files. Buttons are filtered to agents installed
+  on the machine; a typed prompt is shell-quoted and spliced into the launch
+  command for agents that accept one.
+
+## Language servers
+
+xtralab ships with
+[`jupyterlab-lsp`](https://github.com/jupyter-lsp/jupyterlab-lsp) and
+pre-registers two language servers through
+`jupyter_server_config.d/xtralab-lsp.json`:
+
+- **Python — [`ty`](https://github.com/astral-sh/ty)** — installed as a
+  Python dependency. Works out of the box.
+- **TypeScript / JavaScript — `typescript-language-server`** — install
+  yourself:
+
+  ```bash
+  npm install -g typescript-language-server typescript
+  ```
+
+  Restart JupyterLab (or the desktop app) after installing.
+
+Specs use bare command names (`["ty", "server"]`), so binaries are resolved
+from `PATH` at spawn time.
+
+### Where binaries are discovered
+
+- **`pip install xtralab`** — anything on the JupyterLab process's `PATH`.
+- **Desktop app** — the supervisor augments `PATH` with common shim
+  locations (`~/.volta/bin`, `~/.npm-global/bin`, `~/.bun/bin`,
+  `~/.asdf/shims`, `~/.mise/shims`, `/opt/homebrew/bin`, `/usr/local/bin`,
+  …). Set `XTRALAB_EXTRA_PATH` (colon-separated) before launching the app
+  to add directories the defaults miss.
+
+### Adding more servers
+
+To enable another server (bash, yaml, json, dockerfile, pyright, …),
+install the binary then drop a JSON file into a `jupyter_server_config.d/`
+directory:
+
+- **`pip install xtralab`** — run `jupyter --paths` and pick a config dir
+  (typically `~/.jupyter/jupyter_server_config.d/`).
+- **Desktop app (macOS)** —
+  `~/Library/Application Support/xtralab/jupyter/config/jupyter_server_config.d/`
+  (or `xtralab dev` for local dev builds).
+- **Desktop app (Linux AppImage)** —
+  `~/.config/xtralab/jupyter/config/jupyter_server_config.d/`.
+
+Example (`bash-lsp.json`):
+
+```json
+{
+  "LanguageServerManager": {
+    "language_servers": {
+      "bash-language-server": {
+        "version": 2,
+        "argv": ["bash-language-server", "start"],
+        "languages": ["bash", "sh"],
+        "mime_types": ["text/x-sh", "application/x-sh"],
+        "display_name": "bash-language-server"
+      }
+    }
+  }
+}
+```
 
-`xtralab` ships a tiny launcher that opens JupyterLab in a dedicated Chrome
-window (via Chrome's `--app` mode), with an isolated user-data directory so it
-does not share cookies, extensions, or history with your normal browser.
+Pair with `npm install -g bash-language-server`. Reuse a bundled `key` to
+override it. See
+[jupyterlab-lsp's docs](https://jupyterlab-lsp.readthedocs.io/en/latest/Configuring.html)
+for the full spec schema.
 
-Requires Chrome or Chromium installed. macOS only for now; other platforms will be added later.
+## Customizing the launcher
 
-The simplest way, no install needed:
+Open `Settings → Settings Editor → xtralab launcher` and edit the `agents`
+array. Entries are merged with the defaults by `id`.
 
-```bash
-uvx xtralab
-```
+```jsonc
+{
+  "agents": [
+    // Hide an agent
+    { "id": "kiro", "enabled": false },
 
-Or, after `pip install xtralab` into an environment:
+    // Override an agent's command (e.g. point Claude at a shell alias)
+    { "id": "claude", "command": "cl", "requireAvailable": false },
 
-```bash
-xtralab
+    // Add a new agent; promptArgs: [] appends the prompt as a positional arg
+    { "id": "aider", "label": "Aider", "command": "aider", "promptArgs": [] }
+  ]
+}
 ```
 
-The launcher starts a local Jupyter server on a random port with a fresh
-token, waits for it to come up, opens the app window, and shuts the server
-down when you close the window. `Ctrl-C` in the launching terminal also
-shuts everything down cleanly.
+Fields: `id` (required), `label`, `caption`, `command`, `promptArgs` (how to
+splice the prompt — `[]` for positional, `["--flag"]` for flagged, `null` to
+opt out), `iconSvg`, `rank`, `enabled`, `requireAvailable`.
 
-## Development
+## Contributing
 
-```bash
-# Install dependencies and the package in editable mode
-uv pip install -e ".[dev]"
-jlpm
-jlpm build
-```
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for the development setup, the
+Electron desktop app architecture, and the build pipeline.
 
 ## License
 

package/lib/fileBrowser/commands.d.ts

@@ -1,7 +1,7 @@
 import { JupyterFrontEnd } from '@jupyterlab/application';
 import { IXtralabFileBrowser } from './widget';
 /**
- * Command identifiers exposed by the Xtralab browser. We deliberately namespace
+ * Command identifiers exposed by the xtralab browser. We deliberately namespace
  * these under `xtralab:` rather than reusing the `filebrowser:` ids
  * because the core `filebrowser:*` commands look up a `FileBrowser` instance
  * via `IFileBrowserFactory.tracker` — our widget is not a `FileBrowser`, so
@@ -31,7 +31,7 @@ export interface IRegisterCommandsOptions {
     browser: IXtralabFileBrowser;
 }
 /**
- * Register every Xtralab command on the application command registry, attach
+ * Register every xtralab command on the application command registry, attach
  * the items to the application context menu, and wire up the dynamic
  * "Open With" submenu populator.
  *

package/lib/fileBrowser/commands.js

@@ -3,7 +3,7 @@ import { PageConfig, PathExt } from '@jupyterlab/coreutils';
 import { addIcon, closeIcon, CommandToolbarButton, copyIcon, downloadIcon, editIcon, fileIcon, newFolderIcon, refreshIcon } from '@jupyterlab/ui-components';
 import { toCanonicalPath, toServerPath } from './contents';
 /**
- * Command identifiers exposed by the Xtralab browser. We deliberately namespace
+ * Command identifiers exposed by the xtralab browser. We deliberately namespace
  * these under `xtralab:` rather than reusing the `filebrowser:` ids
  * because the core `filebrowser:*` commands look up a `FileBrowser` instance
  * via `IFileBrowserFactory.tracker` — our widget is not a `FileBrowser`, so
@@ -136,7 +136,7 @@ function makeOpenWithUpdater(app, browser) {
     };
 }
 /**
- * Register every Xtralab command on the application command registry, attach
+ * Register every xtralab command on the application command registry, attach
  * the items to the application context menu, and wire up the dynamic
  * "Open With" submenu populator.
  *

package/lib/fileBrowser/fileBrowser.js

@@ -12,7 +12,7 @@ import { FILE_BROWSER_ICONS } from './icons';
  * synchronous function that returns a Widget. The contents MIME types
  * mirror what the default file browser sends so other drop targets that
  * understand them (the file browser itself, custom drop zones) keep
- * working when the user drags out of Xtralab.
+ * working when the user drags out of xtralab.
  */
 const FACTORY_MIME = 'application/vnd.lumino.widget-factory';
 const CONTENTS_MIME = 'application/x-jupyter-icontents';

package/lib/fileBrowser/icons.d.ts

@@ -1,9 +1,9 @@
 import { LabIcon } from '@jupyterlab/ui-components';
 import type { FileTreeIconConfig } from '@pierre/trees';
 /**
- * The glyph used as the Xtralab file browser's sidebar tab icon. Defined as a
+ * The glyph used as the xtralab file browser's sidebar tab icon. Defined as a
  * `LabIcon` (rather than the default `folderIcon` from
- * `@jupyterlab/ui-components`) so the Xtralab browser is visually distinguishable
+ * `@jupyterlab/ui-components`) so the xtralab browser is visually distinguishable
  * from JupyterLab's built-in file browser, which also lives in the left
  * sidebar.
  *
@@ -14,7 +14,7 @@ import type { FileTreeIconConfig } from '@pierre/trees';
  */
 export declare const xtralabFileBrowserIcon: LabIcon;
 /**
- * Icon configuration for the Xtralab file browser. Keeps the default `complete`
+ * Icon configuration for the xtralab file browser. Keeps the default `complete`
  * built-in icon set (the colored language icons) and layers a Jupyter notebook
  * symbol on top so `.ipynb` files render with the JupyterLab notebook glyph.
  *
@@ -24,7 +24,7 @@ export declare const xtralabFileBrowserIcon: LabIcon;
  */
 export declare const FILE_BROWSER_ICONS: FileTreeIconConfig;
 /**
- * Return a JupyterLab `LabIcon` matching the icon the Xtralab file tree would
+ * Return a JupyterLab `LabIcon` matching the icon the xtralab file tree would
  * render for the given file path. Used by other plugins (e.g. the git diff
  * viewer) that want their main-area widget tabs to display the same per-file
  * glyph the tree shows in the sidebar.

package/lib/fileBrowser/icons.js

@@ -2,9 +2,9 @@ var _a;
 import { LabIcon, fileIcon } from '@jupyterlab/ui-components';
 import { createFileTreeIconResolver, getBuiltInFileIconColor, getBuiltInSpriteSheet } from '@pierre/trees';
 /**
- * The glyph used as the Xtralab file browser's sidebar tab icon. Defined as a
+ * The glyph used as the xtralab file browser's sidebar tab icon. Defined as a
  * `LabIcon` (rather than the default `folderIcon` from
- * `@jupyterlab/ui-components`) so the Xtralab browser is visually distinguishable
+ * `@jupyterlab/ui-components`) so the xtralab browser is visually distinguishable
  * from JupyterLab's built-in file browser, which also lives in the left
  * sidebar.
  *
@@ -42,7 +42,7 @@ const JUPYTER_NOTEBOOK_SPRITE_SHEET = `<svg data-icon-sprite aria-hidden="true"
   </symbol>
 </svg>`;
 /**
- * Icon configuration for the Xtralab file browser. Keeps the default `complete`
+ * Icon configuration for the xtralab file browser. Keeps the default `complete`
  * built-in icon set (the colored language icons) and layers a Jupyter notebook
  * symbol on top so `.ipynb` files render with the JupyterLab notebook glyph.
  *
@@ -105,7 +105,7 @@ function extractSymbol(symbolId) {
     };
 }
 /**
- * Return a JupyterLab `LabIcon` matching the icon the Xtralab file tree would
+ * Return a JupyterLab `LabIcon` matching the icon the xtralab file tree would
  * render for the given file path. Used by other plugins (e.g. the git diff
  * viewer) that want their main-area widget tabs to display the same per-file
  * glyph the tree shows in the sidebar.

package/lib/fileBrowser/widget.d.ts

@@ -5,7 +5,7 @@ import { ISignal } from '@lumino/signaling';
 import { Widget } from '@lumino/widgets';
 export declare const FILE_BROWSER_ID = "xtralab:file-browser";
 /**
- * The CSS class added to the Xtralab file browser widget. The selectors that
+ * The CSS class added to the xtralab file browser widget. The selectors that
  * bind application context menu items hang off this class, so it must remain
  * specific enough not to clash with other browsers (such as the default
  * `jp-FileBrowser`).
@@ -17,7 +17,7 @@ export interface IXtralabFileBrowserOptions {
     onOpenFile?: (serverPath: string) => void;
 }
 /**
- * Public API of the Xtralab file browser used by command handlers and other
+ * Public API of the xtralab file browser used by command handlers and other
  * collaborators. Kept narrow on purpose so the React component stays free to
  * evolve the underlying tree integration.
  */

package/lib/fileBrowser/widget.js

@@ -6,7 +6,7 @@ import { FileBrowserComponent } from './fileBrowser';
 import { xtralabFileBrowserIcon } from './icons';
 export const FILE_BROWSER_ID = 'xtralab:file-browser';
 /**
- * The CSS class added to the Xtralab file browser widget. The selectors that
+ * The CSS class added to the xtralab file browser widget. The selectors that
  * bind application context menu items hang off this class, so it must remain
  * specific enough not to clash with other browsers (such as the default
  * `jp-FileBrowser`).
@@ -32,7 +32,7 @@ export class XtralabFileBrowser extends Widget {
         this._onOpenFile = options.onOpenFile;
         this.id = FILE_BROWSER_ID;
         this.title.icon = xtralabFileBrowserIcon;
-        this.title.caption = 'Xtralab File Browser';
+        this.title.caption = 'xtralab File Browser';
         this.addClass(FILE_BROWSER_CSS_CLASS);
         this._toolbar = new Toolbar();
         this._toolbar.addClass(TOOLBAR_CSS_CLASS);

package/lib/git/icons.d.ts

@@ -5,7 +5,7 @@ import { LabIcon } from '@jupyterlab/ui-components';
  * recoloring and inverse-color sidebar painting automatically.
  *
  * Source: `git-branch` from SVG Repo (https://www.svgrepo.com/svg/377352/git-branch),
- * part of the same Pixelarticons family as the Xtralab file browser's `file-tree`
+ * part of the same Pixelarticons family as the xtralab file browser's `file-tree`
  * icon, so the two sidebar tab glyphs read as a matched set. The original
  * `fill="#000000"` is replaced with `fill="currentColor"` and the root element
  * is given the `jp-icon3` class so the icon picks up JupyterLab's theme color

package/lib/git/icons.js

@@ -5,7 +5,7 @@ import { LabIcon } from '@jupyterlab/ui-components';
  * recoloring and inverse-color sidebar painting automatically.
  *
  * Source: `git-branch` from SVG Repo (https://www.svgrepo.com/svg/377352/git-branch),
- * part of the same Pixelarticons family as the Xtralab file browser's `file-tree`
+ * part of the same Pixelarticons family as the xtralab file browser's `file-tree`
  * icon, so the two sidebar tab glyphs read as a matched set. The original
  * `fill="#000000"` is replaced with `fill="currentColor"` and the root element
  * is given the `jp-icon3` class so the icon picks up JupyterLab's theme color

package/lib/launcher/dashboard.js

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { LabIcon, ReactWidget, refreshIcon } from '@jupyterlab/ui-components';
+import { LabIcon, ReactWidget, consoleIcon, notebookIcon, refreshIcon, terminalIcon } from '@jupyterlab/ui-components';
 import { expandStatusFiles, status } from '../git/api';
 import { CommandIDs as GitCommandIDs } from '../git/commands';
 import { agentCommandId } from './commands';
@@ -63,12 +63,40 @@ function LauncherDashboardComponent(props) {
             onAgentLaunch(result);
         }
     }, [commands, cwd, prompt, onAgentLaunch]);
+    const launchTerminal = React.useCallback(async () => {
+        const result = (await commands.execute('terminal:create-new', {
+            cwd
+        }));
+        if (result) {
+            onAgentLaunch(result);
+        }
+    }, [commands, cwd, onAgentLaunch]);
+    const launchNotebook = React.useCallback(async () => {
+        // No `kernelName` — let the notebook extension fall back to the default
+        // kernel or prompt the user, matching the stock launcher's notebook
+        // tile behavior.
+        const result = (await commands.execute('notebook:create-new', {
+            cwd
+        }));
+        if (result) {
+            onAgentLaunch(result);
+        }
+    }, [commands, cwd, onAgentLaunch]);
+    const launchConsole = React.useCallback(async () => {
+        const result = (await commands.execute('console:create', {
+            cwd
+        }));
+        if (result) {
+            onAgentLaunch(result);
+        }
+    }, [commands, cwd, onAgentLaunch]);
     const openDiff = React.useCallback((change) => {
         const args = { repoPath, change };
         void commands.execute(GitCommandIDs.openDiff, args);
     }, [commands, repoPath]);
     return (React.createElement("div", { className: "jp-xtralab-Launcher-body" },
         React.createElement(AgentSection, { agents: agents, prompt: prompt, onPromptChange: setPrompt, onLaunch: launch }),
+        React.createElement(OpenSection, { onLaunchTerminal: launchTerminal, onLaunchNotebook: launchNotebook, onLaunchConsole: launchConsole }),
         React.createElement(ChangesSection, { git: git, onOpen: openDiff, onRefresh: () => void refresh() })));
 }
 function ChangesSection(props) {
@@ -162,3 +190,25 @@ function AgentSection(props) {
                 React.createElement("span", { className: "jp-xtralab-Launcher-agent-label" }, agent.label)));
         }))));
 }
+/**
+ * The non-agent launch tiles — a plain terminal, a new notebook, and a
+ * new console. They sit in a separate section below the agent grid so
+ * they don't compete with the AI agents visually, and they're always
+ * available regardless of the agent prompt textarea (which doesn't
+ * apply to them).
+ */
+function OpenSection(props) {
+    const { onLaunchTerminal, onLaunchNotebook, onLaunchConsole } = props;
+    return (React.createElement("section", { className: "jp-xtralab-Launcher-section" },
+        React.createElement("h2", { className: "jp-xtralab-Launcher-section-title" }, "Open"),
+        React.createElement("div", { className: "jp-xtralab-Launcher-agents" },
+            React.createElement("button", { type: "button", className: "jp-xtralab-Launcher-agent", title: "Open a new terminal.", "aria-label": "Open a new terminal", onClick: onLaunchTerminal },
+                React.createElement(LabIcon.resolveReact, { icon: terminalIcon, tag: "span", className: "jp-xtralab-Launcher-agent-icon" }),
+                React.createElement("span", { className: "jp-xtralab-Launcher-agent-label" }, "Terminal")),
+            React.createElement("button", { type: "button", className: "jp-xtralab-Launcher-agent", title: "Create a new notebook.", "aria-label": "Create a new notebook", onClick: onLaunchNotebook },
+                React.createElement(LabIcon.resolveReact, { icon: notebookIcon, tag: "span", className: "jp-xtralab-Launcher-agent-icon" }),
+                React.createElement("span", { className: "jp-xtralab-Launcher-agent-label" }, "Notebook")),
+            React.createElement("button", { type: "button", className: "jp-xtralab-Launcher-agent", title: "Create a new console.", "aria-label": "Create a new console", onClick: onLaunchConsole },
+                React.createElement(LabIcon.resolveReact, { icon: consoleIcon, tag: "span", className: "jp-xtralab-Launcher-agent-icon" }),
+                React.createElement("span", { className: "jp-xtralab-Launcher-agent-label" }, "Console")))));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "xtralab",
-    "version": "0.2.0",
+    "version": "0.3.0",
     "description": "An opinionated JupyterLab meta-package that bundles a curated set of extensions, ships a path-first file browser and a VS Code-style git changes panel, and applies a quieter default workspace configuration.",
     "keywords": [
         "jupyter",
@@ -145,12 +145,26 @@
         ],
         "parser": "@typescript-eslint/parser",
         "parserOptions": {
-            "project": "tsconfig.json",
+            "project": [
+                "tsconfig.json",
+                "desktop/tsconfig.json",
+                "desktop/tsconfig.forge.json"
+            ],
             "sourceType": "module"
         },
         "plugins": [
             "@typescript-eslint"
         ],
+        "overrides": [
+            {
+                "files": [
+                    "desktop/src/**/*.ts"
+                ],
+                "rules": {
+                    "@typescript-eslint/naming-convention": "off"
+                }
+            }
+        ],
         "rules": {
             "@typescript-eslint/naming-convention": [
                 "error",

package/src/fileBrowser/commands.ts

@@ -27,7 +27,7 @@ import { toCanonicalPath, toServerPath } from './contents';
 import { IXtralabFileBrowser } from './widget';
 
 /**
- * Command identifiers exposed by the Xtralab browser. We deliberately namespace
+ * Command identifiers exposed by the xtralab browser. We deliberately namespace
  * these under `xtralab:` rather than reusing the `filebrowser:` ids
  * because the core `filebrowser:*` commands look up a `FileBrowser` instance
  * via `IFileBrowserFactory.tracker` — our widget is not a `FileBrowser`, so
@@ -198,7 +198,7 @@ function makeOpenWithUpdater(
 }
 
 /**
- * Register every Xtralab command on the application command registry, attach
+ * Register every xtralab command on the application command registry, attach
  * the items to the application context menu, and wire up the dynamic
  * "Open With" submenu populator.
  *

package/src/fileBrowser/fileBrowser.tsx

@@ -32,7 +32,7 @@ type LoadState = 'unloaded' | 'loading' | 'loaded';
  * synchronous function that returns a Widget. The contents MIME types
  * mirror what the default file browser sends so other drop targets that
  * understand them (the file browser itself, custom drop zones) keep
- * working when the user drags out of Xtralab.
+ * working when the user drags out of xtralab.
  */
 const FACTORY_MIME = 'application/vnd.lumino.widget-factory';
 const CONTENTS_MIME = 'application/x-jupyter-icontents';

package/src/fileBrowser/icons.ts

@@ -7,9 +7,9 @@ import {
 import type { FileTreeIconConfig } from '@pierre/trees';
 
 /**
- * The glyph used as the Xtralab file browser's sidebar tab icon. Defined as a
+ * The glyph used as the xtralab file browser's sidebar tab icon. Defined as a
  * `LabIcon` (rather than the default `folderIcon` from
- * `@jupyterlab/ui-components`) so the Xtralab browser is visually distinguishable
+ * `@jupyterlab/ui-components`) so the xtralab browser is visually distinguishable
  * from JupyterLab's built-in file browser, which also lives in the left
  * sidebar.
  *
@@ -49,7 +49,7 @@ const JUPYTER_NOTEBOOK_SPRITE_SHEET = `<svg data-icon-sprite aria-hidden="true"
 </svg>`;
 
 /**
- * Icon configuration for the Xtralab file browser. Keeps the default `complete`
+ * Icon configuration for the xtralab file browser. Keeps the default `complete`
  * built-in icon set (the colored language icons) and layers a Jupyter notebook
  * symbol on top so `.ipynb` files render with the JupyterLab notebook glyph.
  *
@@ -121,7 +121,7 @@ function extractSymbol(
 }
 
 /**
- * Return a JupyterLab `LabIcon` matching the icon the Xtralab file tree would
+ * Return a JupyterLab `LabIcon` matching the icon the xtralab file tree would
  * render for the given file path. Used by other plugins (e.g. the git diff
  * viewer) that want their main-area widget tabs to display the same per-file
  * glyph the tree shows in the sidebar.

package/src/fileBrowser/widget.tsx

@@ -12,7 +12,7 @@ import { xtralabFileBrowserIcon } from './icons';
 export const FILE_BROWSER_ID = 'xtralab:file-browser';
 
 /**
- * The CSS class added to the Xtralab file browser widget. The selectors that
+ * The CSS class added to the xtralab file browser widget. The selectors that
  * bind application context menu items hang off this class, so it must remain
  * specific enough not to clash with other browsers (such as the default
  * `jp-FileBrowser`).
@@ -29,7 +29,7 @@ export interface IXtralabFileBrowserOptions {
 }
 
 /**
- * Public API of the Xtralab file browser used by command handlers and other
+ * Public API of the xtralab file browser used by command handlers and other
  * collaborators. Kept narrow on purpose so the React component stays free to
  * evolve the underlying tree integration.
  */
@@ -100,7 +100,7 @@ export class XtralabFileBrowser extends Widget implements IXtralabFileBrowser {
     this._onOpenFile = options.onOpenFile;
     this.id = FILE_BROWSER_ID;
     this.title.icon = xtralabFileBrowserIcon;
-    this.title.caption = 'Xtralab File Browser';
+    this.title.caption = 'xtralab File Browser';
     this.addClass(FILE_BROWSER_CSS_CLASS);
 
     this._toolbar = new Toolbar();

package/src/git/icons.ts

@@ -6,7 +6,7 @@ import { LabIcon } from '@jupyterlab/ui-components';
  * recoloring and inverse-color sidebar painting automatically.
  *
  * Source: `git-branch` from SVG Repo (https://www.svgrepo.com/svg/377352/git-branch),
- * part of the same Pixelarticons family as the Xtralab file browser's `file-tree`
+ * part of the same Pixelarticons family as the xtralab file browser's `file-tree`
  * icon, so the two sidebar tab glyphs read as a matched set. The original
  * `fill="#000000"` is replaced with `fill="currentColor"` and the root element
  * is given the `jp-icon3` class so the icon picks up JupyterLab's theme color

package/src/launcher/dashboard.tsx

@@ -2,7 +2,14 @@ import * as React from 'react';
 
 import type { CommandRegistry } from '@lumino/commands';
 import type { ReadonlyPartialJSONObject } from '@lumino/coreutils';
-import { LabIcon, ReactWidget, refreshIcon } from '@jupyterlab/ui-components';
+import {
+  LabIcon,
+  ReactWidget,
+  consoleIcon,
+  notebookIcon,
+  refreshIcon,
+  terminalIcon
+} from '@jupyterlab/ui-components';
 import type { Widget } from '@lumino/widgets';
 
 import { expandStatusFiles, status } from '../git/api';
@@ -133,6 +140,36 @@ function LauncherDashboardComponent(
     [commands, cwd, prompt, onAgentLaunch]
   );
 
+  const launchTerminal = React.useCallback(async () => {
+    const result = (await commands.execute('terminal:create-new', {
+      cwd
+    })) as Widget | undefined;
+    if (result) {
+      onAgentLaunch(result);
+    }
+  }, [commands, cwd, onAgentLaunch]);
+
+  const launchNotebook = React.useCallback(async () => {
+    // No `kernelName` — let the notebook extension fall back to the default
+    // kernel or prompt the user, matching the stock launcher's notebook
+    // tile behavior.
+    const result = (await commands.execute('notebook:create-new', {
+      cwd
+    })) as Widget | undefined;
+    if (result) {
+      onAgentLaunch(result);
+    }
+  }, [commands, cwd, onAgentLaunch]);
+
+  const launchConsole = React.useCallback(async () => {
+    const result = (await commands.execute('console:create', {
+      cwd
+    })) as Widget | undefined;
+    if (result) {
+      onAgentLaunch(result);
+    }
+  }, [commands, cwd, onAgentLaunch]);
+
   const openDiff = React.useCallback(
     (change: IFileChange) => {
       const args: GitCommandArguments.IOpenDiff = { repoPath, change };
@@ -152,6 +189,11 @@ function LauncherDashboardComponent(
         onPromptChange={setPrompt}
         onLaunch={launch}
       />
+      <OpenSection
+        onLaunchTerminal={launchTerminal}
+        onLaunchNotebook={launchNotebook}
+        onLaunchConsole={launchConsole}
+      />
       <ChangesSection
         git={git}
         onOpen={openDiff}
@@ -354,3 +396,67 @@ function AgentSection(props: {
     </section>
   );
 }
+
+/**
+ * The non-agent launch tiles — a plain terminal, a new notebook, and a
+ * new console. They sit in a separate section below the agent grid so
+ * they don't compete with the AI agents visually, and they're always
+ * available regardless of the agent prompt textarea (which doesn't
+ * apply to them).
+ */
+function OpenSection(props: {
+  onLaunchTerminal: () => void;
+  onLaunchNotebook: () => void;
+  onLaunchConsole: () => void;
+}): React.ReactElement {
+  const { onLaunchTerminal, onLaunchNotebook, onLaunchConsole } = props;
+  return (
+    <section className="jp-xtralab-Launcher-section">
+      <h2 className="jp-xtralab-Launcher-section-title">Open</h2>
+      <div className="jp-xtralab-Launcher-agents">
+        <button
+          type="button"
+          className="jp-xtralab-Launcher-agent"
+          title="Open a new terminal."
+          aria-label="Open a new terminal"
+          onClick={onLaunchTerminal}
+        >
+          <LabIcon.resolveReact
+            icon={terminalIcon}
+            tag="span"
+            className="jp-xtralab-Launcher-agent-icon"
+          />
+          <span className="jp-xtralab-Launcher-agent-label">Terminal</span>
+        </button>
+        <button
+          type="button"
+          className="jp-xtralab-Launcher-agent"
+          title="Create a new notebook."
+          aria-label="Create a new notebook"
+          onClick={onLaunchNotebook}
+        >
+          <LabIcon.resolveReact
+            icon={notebookIcon}
+            tag="span"
+            className="jp-xtralab-Launcher-agent-icon"
+          />
+          <span className="jp-xtralab-Launcher-agent-label">Notebook</span>
+        </button>
+        <button
+          type="button"
+          className="jp-xtralab-Launcher-agent"
+          title="Create a new console."
+          aria-label="Create a new console"
+          onClick={onLaunchConsole}
+        >
+          <LabIcon.resolveReact
+            icon={consoleIcon}
+            tag="span"
+            className="jp-xtralab-Launcher-agent-icon"
+          />
+          <span className="jp-xtralab-Launcher-agent-label">Console</span>
+        </button>
+      </div>
+    </section>
+  );
+}