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 'dart:io';
/// Opens [path] in the OS file manager — Finder on macOS, whatever `xdg-open`
/// resolves to on Linux.
///
/// For the one thing an app can hand a user that a screen cannot: the log files
/// themselves. `~/.harness/logs` is a hidden directory, and telling somebody to
/// type a dotted path into Finder is how a bug report ends instead of starts.
///
/// Returns whether the file manager was launched — false covers both a missing
/// directory and a machine with no handler for one, which is as much as the
/// caller can act on.
Future<bool> revealFolder(String path) async {
if (!Directory(path).existsSync()) return false;
return _openWithSystem(path);
}
/// Opens the file at [path] in the app the system gives its kind — Preview
/// for a PDF, the person's player for a video. For what a Finder tile cannot
/// draw itself.
Future<bool> openFile(String path) async {
if (!File(path).existsSync()) return false;
return _openWithSystem(path);
}
Future<bool> _openWithSystem(String path) async {
final executable = Platform.isMacOS
? '/usr/bin/open'
: Platform.isWindows
? 'explorer'
: 'xdg-open';
try {
final result = await Process.run(executable, [path]);
// `explorer` answers 1 even when it opened the window it was asked for.
return result.exitCode == 0 || Platform.isWindows;
} on ProcessException {
return false;
}
}
/// Selects [path] in the file manager — Finder's "Reveal", or the containing
/// folder where the platform has no such thing. For a file the app just wrote
/// and wants the user to find: the exported log bundle.
Future<bool> revealFile(String path) async {
if (!File(path).existsSync()) return false;
if (Platform.isMacOS) {
try {
final result = await Process.run('/usr/bin/open', ['-R', path]);
return result.exitCode == 0;
} on ProcessException {
return false;
}
}
return revealFolder(File(path).parent.path);
}