A desktop coding agent with free access to frontier models.
TypeScript
import { annotateShellOutput, check, checkManagedTool } from "./managed-policy-client.js";
import { applyEnginePath } from "../engine-shell-path.js";
import { blankShellSecrets } from "./shell-secret-env.js";
type ToolBeforeInput = { tool: string; sessionID?: string; callID?: string };
type ToolAfterInput = { tool: string; sessionID?: string; callID?: string; args?: unknown };
export default async function managedPolicy(input?: { directory?: string }) {
// Same tool directories the packaged app resolves for the server, applied
// to the engine process so the bash tool finds git and gh in dev too.
const enginePath = applyEnginePath();
const directory = input?.directory;
return {
"tool.execute.before": async (event: ToolBeforeInput, output: { args: unknown }) =>
checkManagedTool(event.tool, output.args, { directory, callID: event.callID, sessionID: event.sessionID }),
"tool.execute.after": async (event: ToolAfterInput, output: { title: string; output: string; metadata: unknown }) => {
if (event.tool !== "bash" && event.tool !== "shell") return;
output.output = annotateShellOutput(event.callID, output.output);
},
"shell.env": async (event: { cwd: string; callID?: string; sessionID?: string }, output: { env: Record<string, string> }) => {
// The app's own secrets never reach a command the agent runs (shell-secret-env.ts).
blankShellSecrets(output.env);
if (enginePath) output.env.PATH = enginePath;
// The call and session the shell runs for: the install log's wrappers note them, so an
// install is tied to the very call that ran it (parallel calls, a sub-agent's, one in the background).
if (event?.callID) output.env.OMNIRUSH_CALL = String(event.callID);
if (event?.sessionID) output.env.OMNIRUSH_SESSION = String(event.sessionID);
// The engine runs with a data home of its own (engine-data-home.ts);
// commands the agent runs get the user's back.
const userDataHome = process.env.OMNIRUSH_USER_XDG_DATA_HOME?.trim();
if (userDataHome) output.env.XDG_DATA_HOME = userDataHome;
},
"chat.params": async (input: { model: { providerID: string; id: string } }) => { await check("model", input.model); },
};
}