An agentic browser harness: an AI side panel & orb in your own logged-in Chrome, Edge, Arc, Brave or even Firefox run by the agent/subscription you already use (Claude Code, Codex, Antigravity). Free, open source, no API key. Also an MCP server.
TypeScript agentic-browseragentic-browsingagy-cliaiai-agentai-browser-extensionai-toolsbrave-extensionbrowser-agentbrowser-automationbrowser-extensionbrowser-usebrowserskillchrome-extensionclaude-codecodexfirefox-addonmcp-servernanobrowserweb-automation
import { chmodSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
import { join } from 'node:path';
import { stateDir } from './paths.js';
// stateDir moved to paths.ts once the extension install needed a second root. Re-exported
// here because most of the package already imports it from this module.
export { stateDir };
export const lockfilePath = join(stateDir, 'daemon.json');
export const logPath = join(stateDir, 'daemon.log');
export interface Lockfile {
pid: number;
port: number;
token: string;
protocolVersion: number;
daemonVersion: string;
}
export function readLockfile(): Lockfile | null {
try {
const lock = JSON.parse(readFileSync(lockfilePath, 'utf8')) as Lockfile;
return typeof lock?.port === 'number' && typeof lock?.token === 'string' ? lock : null;
} catch {
return null;
}
}
export function writeLockfile(lock: Lockfile): void {
mkdirSync(stateDir, { recursive: true, mode: 0o700 });
writeFileSync(lockfilePath, `${JSON.stringify(lock, null, 2)}\n`, { mode: 0o600 });
chmodSync(lockfilePath, 0o600);
}
export function clearLockfile(): void {
rmSync(lockfilePath, { force: true });
}
/**
* Left by a stop and cleared by the next daemon to start. While it is there the browser's
* wake-up leaves the daemon down, so `browsentic stop` is not undone a second later by a
* paired browser reconnecting.
*/
export const stoppedPath = join(stateDir, 'stopped');
export function holdWake(): void {
mkdirSync(stateDir, { recursive: true, mode: 0o700 });
writeFileSync(stoppedPath, `${new Date().toISOString()}\n`, { mode: 0o600 });
}
export function releaseWake(): void {
rmSync(stoppedPath, { force: true });
}
export const wakeHeld = (): boolean => existsSync(stoppedPath);
export function isRunning(pid: number): boolean {
try {
process.kill(pid, 0);
return true;
} catch (error) {
return (error as NodeJS.ErrnoException).code === 'EPERM';
}
}