— Hudson app

This component is a Hudson embed.

Everything you see around this text — nav, panels, status, the chrome — is a real Hudson primitive. Same shell any app inherits.

BUILD SEQUENCE · DECLARE → WIRE → COMPOSE → RUN
§ STEP 01
1DECLARE
typed manifest
{ id: 'docs',
  mode: 'canvas' }
§ STEP 02
2WIRE
intents indexed
→ ⌘K
→ voice
§ STEP 03
3COMPOSE
drop primitives
<Frame>
  <Nav/>
</Frame>
§ STEP 04
4RUN
standard dev
$ bun dev
Hudson Docs

HUDSON

Reference cards for the Hudson component library. Click to open.

Guides
Hudson AI
Hudson AI Control Surface
Use Console AI to act. Use this app to inspect what Hudson AI can see, manage Hudson defaults, and override them for the current workspace when needed.
AI provider: GitHub CopilotAI model: gemini-3-flash-previewvoice provider: Voxconfig source: Hudson Default
Runtime Configuration
AI Provider
GitHub Copilot
AI Model
gemini-3-flash-preview
Voice Provider
Vox
Config Source
Hudson Default
Run Commands
Invoke any live shell or app command that Hudson has ingested from the workspace.
Edit Settings
Change app settings and shell settings through the same bridges used by Hudson itself.
Manage Apps
Show, hide, focus, or disable apps inside the current workspace.
Operate Services
Check, start, stop, or install workspace services when the service bridge is available.
Work Pipes
Inspect, create, push, and delete pipes that move data between Hudson apps.
Manage Environment
Set or remove local .env.local values through Hudson’s environment surface.
Generate Assets
Generate images when the host image-generation bridge is available.
Settings Scope
Hudson Preferences
Global Shell
Voice capture, speak-back, reply behavior, and environment credentials live at the shell level. They affect Hudson globally, not only the Hudson AI app.
Voice provider: Vox
Voice model: avspeech:system
Reply behavior: Balanced
Hudson AI Resolution
Hudson Default
Hudson sets the default AI provider and model once. The current workspace can override that runtime when it needs a different pair.
Hudson default: GitHub Copilot / gemini-3-flash-preview
Current workspace: GitHub Copilot / gemini-3-flash-preview
Source: Hudson Default
Runtime Snapshot
Focused App
Hudson Docs
Command Surface
Console AI can reach live shell, app, and service actions exposed by the current workspace.
Intent Catalog
Intent metadata stays available for shell and workspace apps when you want to inspect or route structured actions.
Environment
Hudson can manage local environment values at .env.local.
Voice Workflow
These are global Hudson preferences. They shape the voice loop for Hudson overall, not only this app.
Global Shell
Capture
Immediate send
Speak Back
Off
Reply BehaviorBalanced
Spoken DetailBalanced
Long RepliesInvite discussion after 720 chars
Code RepliesExplain the gist, keep code in text
Voice ProviderVox / avspeech:system
Reply VoiceDefault voice
Reply Speed1.00x
Next Turn
Your next utterance will send immediately, but the reply will stay text-only.
Voice Loop Notes
Transcription Path
Capture runs through Hudson Menu’s embedded Vox daemon, so Hudson owns microphone permission and the recording lifecycle.
Spoken Replies
Reply audio runs through Hudson’s local Vox-backed speech endpoint, with voices and models populated from Vox.
Intents
Theme Designer
hudson / dark
Theme Designer
Live editing hudson / dark
hudson · dark

Canonical preview surface

Chrome, content, focus, status, and type primitives all read from the same CSS custom properties that embeds receive through the template/theme attributes.

Component primitives

Buttons, cards, badges, and status colors.

Card

Surface contrast

Cards use --card, borders use --border.

Focus ring
Type + code

Heading one

Heading two

Heading three

Heading four

Body text stays quiet and legible over the selected background. Use contrast readouts to confirm each pair before saving.

const theme = {
  template: 'hudson',
  theme: 'dark',
  accent: 'oklch(var(--accent))',
};
foreground / background—
accent foreground / accent—
card foreground / card—
Navigation
Reference
Map
Inspector
Selected
Click a component to inspect
hudson.view.mode
canvas
hudson.view.nav
overview
hudson.sheets.open
0
⌘K
READY
--:--
Hudson AI
livecopilotgemini-3-flash-previewHudsonKit Docs
Ask me anything about the workspace. I can act live in the current workspace, peek into another workspace, or load that workspace when you want to switch over.