Local developer tools for working with coding agents.

Marbles

Automation as code.

Modules in .foundry/marbles/ define the work, where an agent participates, and what makes it run again. Run it once or keep Marbles running in a terminal for schedules and monitors. State lives on disk between invocations.

• stepdoes one piece of work
• workflowconnects those pieces
• agentsupplies instructions to a coding-agent harness
• sessionretains a conversation across runs
• monitorreacts when a source changes
• scheduledecides when work returns

import { step } from "@foundry.sh/marbles";

step("inspect").do(async ({ workspaces, log }) => {
  const files = await workspaces.current.files();
  log(files.length, "files");
  return { files: files.length };
});

A deterministic step needs no model call. Save it and run marbles roll inspect.

Spyglass

A map of your codebase.

Point Spyglass at a directory. It analyzes the packages and files it finds, saves the result outside the workspace, and serves a local viewer that renders packages as territories, files as settlements, and dependencies as the routes between them. The workspace itself is never modified.

spyglass scan ./my-workspace
spyglass serve ./my-workspace
spyglass ./my-workspace

scan analyzes and saves, serve shows the last result, and the bare form does both and opens the browser.