Use your coding agent
Let Claude Code, Codex or Cursor write, run and read your experiments.
louped has no agent of its own. It connects to the one you already use.
louped init writes three things your agent reads:
AGENTS.md: how to work in the project..mcp.json: startslouped mcp, which talks to the running app..claude/skills/: steps for starting an experiment, reading results, running on a cluster, writing a report, changing the app's pages and adding a plugin.
Start the app with louped serve, then open your agent in the project folder and ask it what to
test.
Tools the agent gets
| Tool | What it does |
|---|---|
experiments, experiment, runs, run | Lists questions and runs |
samples, sample, figures, figure, compare | Reads results |
new_experiment | Starts a question |
launchables, launch_options, launch | Starts a job |
jobs, job, cancel_job | Follows or stops jobs |
export_job, import_result | Sends a job to a cluster, brings it back |
push, pull | Shares runs through the remote |
ui_page, ui_selection | Reads the app's pages and what you picked |
set_part, set_layout, set_preset | Changes what a page shows |
ui_show | Points you at parts of a page, with a note |
cohort, cohorts, save_cohort | Reads and saves a set of a run's items |
add_view, derive | Adds a figure or columns from a run's files |
Work the agent starts shows in the app like your own. To ask about or change something on a page, Shift+click it (as many parts as you like) and your agent gets them with their data (Customize the app).
Ask for a view the app lacks ("these claims in 3D", "a column for which ones hedge") and the agent makes it where it belongs: a column in the run's Items, a figure on the run or on the experiment's page, then points you at it. Ask again to change it; it keeps the name.
Without louped init
Add this to your agent's MCP config. Use uv run louped mcp if louped is installed in a uv
project.
{ "mcpServers": { "louped": { "command": "louped", "args": ["mcp"] } } }In Claude Code you can also install it as a plugin:
/plugin marketplace add ashworks1706/louped
/plugin install louped@louped