Silo

Interface: SystemService ​

Defined in: packages/sdk/src/system-service.ts:70

Read-only snapshot of the host machine and Silo version. Exposed as ExtensionContext.system.

All values are static — they are baked into the binary at compile time and do not change during a session. getInfo() resolves on the first call and returns the cached result on every subsequent call.

Example ​

ts
export const extension: Extension = {
  id: "my.platform-aware",
  async activate(ctx) {
    const { os, arch, siloVersion } = await ctx.system.getInfo();

    if (os === "macos") {
      // Register a macOS-specific command.
      ctx.subscriptions.push(
        ctx.registerCommand({
          id: "my.reveal-in-finder",
          label: "Reveal in Finder",
          run() { ... },
        }),
      );
    }

    ctx.ui.notify("info", `Running Silo ${siloVersion} on ${os}/${arch}`);
  },
};

Methods ​

getInfo() ​

ts
getInfo(): Promise<SystemInfo>;

Defined in: packages/sdk/src/system-service.ts:75

Resolve the host-platform snapshot. Resolves immediately after the first call (the result is cached) — safe to await in activate.

Returns ​

Promise<SystemInfo>

homeDir() ​

ts
homeDir(): Promise<string>;

Defined in: packages/sdk/src/system-service.ts:96

Absolute path of the current user's home directory ($HOME on macOS/Linux, %USERPROFILE% on Windows). Host-mediated — there's no Node/os access in extensions. Resolves immediately after the first call (cached, like SystemService.getInfo).

Returning the path string is not itself a file read: reading or watching anything under it still goes through ExtensionContext.files and that service's normal permission rules (typically fs:read for an untrusted extension).

Returns ​

Promise<string>

Example ​

ts
const home = await ctx.system.homeDir();
const skillsDir = path.join(home, ".claude", "skills");
if (await ctx.files.pathExists(skillsDir)) {
  const entries = await ctx.files.readDir(skillsDir);
}