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 { readdir, stat } from 'fs/promises'
import { join } from 'path'
import { locateProcessSession, locateTranscript, recordCwd } from '../kit/sessionLocation.js'
import { COPILOT_CWD, COPILOT_PROCESS_SESSION, COPILOT_TRANSCRIPT, SESSION_ID } from './contract.js'
export { copilotTranscriptPath } from './contract.js'
export async function findCopilotTranscript(copilotHome: string, sessionId: string): Promise<string | null> {
return locateTranscript(COPILOT_TRANSCRIPT, copilotHome, sessionId)
}
export interface CopilotSessionFile {
sessionId: string
transcriptPath: string
mtimeMs: number
birthMs: number
}
/** Every session with an event stream on disk, newest write first. */
export async function listCopilotSessions(copilotHome: string): Promise<CopilotSessionFile[]> {
const root = join(copilotHome, 'session-state')
const entries = await readdir(root, { withFileTypes: true }).catch(() => [])
const found: CopilotSessionFile[] = []
for (const entry of entries) {
if (!entry.isDirectory() || !SESSION_ID.test(entry.name)) continue
const transcriptPath = join(root, entry.name, 'events.jsonl')
const info = await stat(transcriptPath).catch(() => null)
if (!info?.isFile()) continue
found.push({
sessionId: entry.name,
transcriptPath,
mtimeMs: info.mtimeMs,
birthMs: info.birthtimeMs || info.ctimeMs,
})
}
return found.sort((a, b) => b.mtimeMs - a.mtimeMs)
}
/**
* The cwd a Copilot session was started in, read from its first record.
*
* `session.start` carries `data.context.cwd`. Sessions are named by uuid, not by directory, so this is
* the only link between a session file and the pane that owns it.
*/
export function copilotSessionCwd(firstLines: string[]): string | null {
return recordCwd(firstLines, COPILOT_CWD)
}
/**
* The session a live Copilot process is CURRENTLY in, read from the lock it takes on the directory.
*
* Copilot writes `session-state/<sessionId>/inuse.<pid>.lock` when a process opens a session, and
* `/resume` inside the CLI opens another one — measured: pid 63310 held two locks at once, the session
* it started with and the one it switched to. So the lock is not one-per-process, and the NEWEST is
* the answer.
*
* This is the only trace a resume leaves. It writes nothing to the transcript (measured: pick a
* session and not one byte of `events.jsonl` changes) and fires no hook until the first prompt, which
* is why a directory scan cannot find it and why the agent used to sit unbound after `/resume`.
*/
export async function copilotSessionForPid(copilotHome: string, pid: number): Promise<string | null> {
return locateProcessSession(COPILOT_PROCESS_SESSION, copilotHome, pid)
}