The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.
TypeScript 3d-modelingagent-frameworkagent-harnessai-agentscadclaude-codecodexcoding-agentsdeveloper-toolsesp32game-developmentmcp-servermulti-agentopen-hardwareopencodeopenharnesspcbroboticsterminaltmux
import 'package:harness/shared/theme/app_icons.dart';
import 'package:flutter/material.dart';
import '../shared/theme/app_theme.dart' as grid;
import '../shortcuts/app_keymap.dart';
import '../shortcuts/keymap.dart';
import '../shortcuts/keymap_commands.dart';
import 'desktop_chrome.dart';
import 'welcome_project_example.dart';
/// A quiet, live keyboard map for an empty workspace. The drawing illustrates
/// tabs and panes. Only the full shortcuts link is interactive.
class WorkspaceStartGuide extends StatelessWidget {
const WorkspaceStartGuide({super.key, required this.onShortcuts});
final VoidCallback onShortcuts;
String _hint(BuildContext context, String command) =>
KeymapTheme.of(context)?.hint(command) ??
(KeymapTheme.of(context) == null
? harnessDefaultKeymap
.bindingsFor(KeymapContext.workspace)
.where((binding) => binding.command == command)
.map(describeKeyBinding)
.firstOrNull
: null) ??
'';
@override
Widget build(BuildContext context) {
grid.AppTheme.watch(context);
final ink = DesktopChrome.foreground;
final faint = DesktopChrome.muted;
final accent = DesktopChrome.accent;
final stroke = DesktopChrome.rim;
return Material(
color: DesktopChrome.surface,
child: LayoutBuilder(
builder: (context, constraints) {
final scale = grid.appTextScaleOf(context);
final compact = constraints.maxWidth < 680 * scale;
final short = constraints.maxHeight < 420 * scale;
Widget callout(String command, String label, String explanation) =>
Padding(
padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text.rich(
TextSpan(
children: [
if (_hint(context, command).isNotEmpty)
TextSpan(
text: '${_hint(context, command)} ',
style: TextStyle(color: accent),
),
TextSpan(text: label),
],
),
style: DesktopChrome.control(medium: true),
),
const SizedBox(height: 4),
Text(explanation, style: DesktopChrome.metadata()),
],
),
);
final newTab = callout(
'swarm.new',
'New Tab',
'Group multiple harnesses in one tab.',
);
final store = callout(
'app.store',
'Harness Store',
'Code, 3D design, circuits, video, and more.',
);
final shortcuts = Align(
alignment: Alignment.centerLeft,
child: DesktopPill(
key: const ValueKey('workspace-all-shortcuts'),
onPressed: onShortcuts,
quiet: true,
label:
'${_hint(context, 'keyboard.help')} All keyboard shortcuts'
.trimLeft(),
),
);
final newPane = callout(
'agent.open',
'New Pane',
'Add a harness beside your work.',
);
final diagram = Column(
mainAxisSize: MainAxisSize.min,
children: [
Padding(
padding: const EdgeInsets.only(bottom: 24),
child: Text(
'Follow your curiosity. Build across disciplines.',
textAlign: TextAlign.center,
style: DesktopChrome.heading(),
),
),
if (compact)
Column(
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [newTab, const SizedBox(height: 8), store],
)
else
Row(
mainAxisAlignment: MainAxisAlignment.spaceBetween,
children: [
Flexible(child: newTab),
Flexible(child: store),
],
),
SizedBox(
height: 14,
width: double.infinity,
child: CustomPaint(painter: _GuideArrows(stroke, top: true)),
),
ExcludeSemantics(
child: Container(
decoration: BoxDecoration(
color: DesktopChrome.field,
border: Border.all(color: stroke),
borderRadius: BorderRadius.circular(8),
),
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
Container(
decoration: BoxDecoration(
border: Border(bottom: BorderSide(color: stroke)),
),
padding: const EdgeInsets.symmetric(
horizontal: 16,
vertical: 8,
),
child: Row(
children: [
Expanded(
child: Row(
children: [
Flexible(
child: Text(
'robot arm',
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: DesktopChrome.control(),
),
),
if (!compact) ...[
const SizedBox(width: 32),
Text(
'launch video',
style: DesktopChrome.control(),
),
],
const SizedBox(width: 20),
Icon(AppIcons.plus, size: 16, color: faint),
],
),
),
Text(
compact ? 'Store' : 'Harness Store',
style: DesktopChrome.control(),
),
],
),
),
SizedBox(
height: (constraints.maxHeight - 254 * scale).clamp(
(short ? 220 : 280) * scale,
340 * scale,
),
child: Row(
children: [
Expanded(
child: _DrawnPane(
name: 'Claude Code',
example: WelcomeProjectExample.code,
task: 'Write the robot arm control code',
showLocation: !short,
ink: ink,
faint: faint,
accent: accent,
),
),
VerticalDivider(
width: 1,
thickness: 1,
color: stroke,
),
Expanded(
child: Column(
children: [
Expanded(
child: _DrawnPane(
name: 'Blender',
example: WelcomeProjectExample.gripper,
task: 'Design a printable robot gripper',
showLocation: !short,
ink: ink,
faint: faint,
accent: accent,
),
),
Divider(
height: 1,
thickness: 1,
color: stroke,
),
Expanded(
child: _DrawnPane(
name: 'KiCad',
example: WelcomeProjectExample.circuit,
task: 'Design the motor controller board',
showLocation: !short,
ink: ink,
faint: faint,
accent: accent,
),
),
],
),
),
],
),
),
],
),
),
),
SizedBox(
height: 14,
width: double.infinity,
child: CustomPaint(painter: _GuideArrows(stroke)),
),
if (compact)
Column(
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [newPane, const SizedBox(height: 8), shortcuts],
)
else
Row(
children: [
Expanded(child: shortcuts),
Expanded(child: newPane),
],
),
],
);
final horizontalPadding = compact ? 16.0 : 24.0;
return Padding(
padding: EdgeInsets.symmetric(
horizontal: horizontalPadding,
vertical: 12,
),
child: Center(
// Scroll the reference without shrinking its text.
child: SingleChildScrollView(
child: SizedBox(
key: const ValueKey('workspace-welcome-diagram'),
width: (constraints.maxWidth - horizontalPadding * 2).clamp(
0.0,
1000.0,
),
child: diagram,
),
),
),
);
},
),
);
}
}
class _DrawnPane extends StatelessWidget {
const _DrawnPane({
required this.name,
required this.example,
required this.task,
required this.ink,
required this.faint,
required this.accent,
this.showLocation = true,
});
final String name, task;
final WelcomeProjectExample example;
final Color ink, faint, accent;
final bool showLocation;
@override
Widget build(BuildContext context) {
final copy = Column(
mainAxisSize: MainAxisSize.min,
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
name,
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: DesktopChrome.control(color: ink, medium: true),
),
if (showLocation) ...[
const SizedBox(height: 6),
Text(
'This Mac:~/work/robot-arm',
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: grid.AppType.monoMeta(color: faint),
),
],
const SizedBox(height: 10),
Text.rich(
TextSpan(
children: [
TextSpan(
text: '› ',
style: TextStyle(color: accent),
),
TextSpan(text: '$task ▏'),
],
),
maxLines: 2,
overflow: TextOverflow.ellipsis,
style: grid.AppType.monoLabel(color: ink),
),
],
);
final output = WelcomeProjectOutput(
example: example,
ink: ink,
faint: faint,
);
return Padding(
padding: const EdgeInsets.all(12),
child: example == WelcomeProjectExample.code
? Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
copy,
const SizedBox(height: 16),
Expanded(child: output),
],
)
: Row(
children: [
Expanded(flex: 3, child: copy),
const SizedBox(width: 12),
Expanded(flex: 2, child: output),
],
),
);
}
}
class _GuideArrows extends CustomPainter {
const _GuideArrows(this.color, {this.top = false});
final Color color;
final bool top;
@override
void paint(Canvas canvas, Size size) {
final pen = Paint()
..color = color
..strokeWidth = 1;
void arrow(double x, {required bool down}) {
final tip = Offset(x, down ? size.height - 2 : 2);
canvas.drawLine(Offset(x, down ? 0 : size.height), tip, pen);
for (final side in [-1, 1]) {
canvas.drawLine(tip, tip + Offset(4.0 * side, down ? -5 : 5), pen);
}
}
if (top) {
arrow(56, down: true);
arrow(size.width - 56, down: true);
} else {
arrow(size.width * .75, down: false);
}
}
@override
bool shouldRepaint(_GuideArrows old) => old.color != color || old.top != top;
}