GitHub repositories · by bn-l

autoresearch

Name: autoresearch
Author: bn-l

Autonomous experiment loops for Claude Code: try an idea, measure it, keep what works, discard what doesn't, repeat. A port of pi-autoresearch v1.8.1.

bn-l@bn-l

bn-l/claude-autoresearch-mod/tree/main/plugin

Translated

About this mod

Requires Claude Code 2.1.285+ with CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1. Start with /autoresearch <goal>; /autoresearch alone prints the help. The repository's README covers setup, unattended runs and configuration, and DEVIATIONS.md every difference from upstream.

Installation

Check the author's README for the marketplace and plugin name first. Commands may change as the repository evolves.

claude plugin marketplace add bn-l/claude-autoresearch-mod
claude plugin install autoresearch

Original text / README

autoresearch

Autonomous experiment loops for Claude Code: try an idea, measure it, keep what works, discard what doesn't, repeat. A port of pi-autoresearch v1.8.1.

Project information

Author: bn-l
Use cases: Multi-agent orchestration
Added: Oct 5, 2026
Source updated: Oct 5, 2026
Stars: 2
Permission footprint: L3
views: 0

autonomous-experimentsclaude-codehookspi-autoresearchpluginworkflow

Report this work Is this your work? Claim it

Permission footprint

Automatically scanned data. Review the source before installing. Levels describe capabilities, not a safety certification.

Execute commands
Environment variables
Read files
Write files
Submit prompts
Register tools
Network access
Intercept tool calls

View matches (32）

Execute commands · line79 lineplugin/hooks/register.tsxconst match = /__(init|run|log)_experiment$/.exec(tool)

Environment variables · line149 lineplugin/hooks/register.tsxtmpDir: async () => ((await $.env.get('TMPDIR')) ?? '/tmp').replace(/\/+$/, '') || '/tmp',

Environment variables · line150 lineplugin/hooks/register.tsxparentPid: () => $.env.get('CLAUDE_PID'),

Read files · line161 lineplugin/hooks/register.tsxsize = (await $.fs.stat(path)).size

Read files · line165 lineplugin/hooks/register.tsxif (size < FS_LIMIT_BYTES) return $.fs.read(path)

Execute commands · line167 lineplugin/hooks/register.tsxfor await (const chunk of $.process.spawn({ argv: ['cat', '--', path] })) {

Write files · line172 lineplugin/hooks/register.tsxwriteText: (path, text) => $.fs.write(path, text),

Execute commands · line174 lineplugin/hooks/register.tsxconst result = await $.process.run(

Read files · line183 lineplugin/hooks/register.tsxconst { kind } = await $.fs.stat(path)

Read files · line191 lineplugin/hooks/register.tsxreturn (await $.fs.stat(path, { resolve: true })).realPath ?? null

Execute commands · line196 lineplugin/hooks/register.tsxisExecutable: async path => (await $.process.run(['test', '-x', path])).exitCode === 0,

Execute commands · line198 lineplugin/hooks/register.tsxconst result = await $.process.run(['rm', '-f', '--', path])

Execute commands · line202 lineplugin/hooks/register.tsxrun: (argv, init) => $.process.run(argv, init),

Execute commands · line204 lineplugin/hooks/register.tsxconst stream = $.process.spawn({ argv, cwd: init.cwd, env: init.env })

Submit prompts · line240 lineplugin/hooks/register.tsxvoid $.prompt.submit({ text }).catch(error => {

Register tools · line245 lineplugin/hooks/register.tsxregisterTool: async spec => (await $.tool.register(spec)).tool,

Network access · line286 lineplugin/hooks/register.tsxpost: async (url, body) => ({ status: (await $.http.fetch(url, { method: 'POST', body })).status }),

Execute commands · line288 lineplugin/hooks/register.tsxconst opened = await $.process.run(['open', url]).catch(() => null)

Execute commands · line290 lineplugin/hooks/register.tsxawait $.process.run(['xdg-open', url])

Intercept tool calls · line406 lineplugin/hooks/register.tsxon('tool.call', { tool: OUR_TOOLS }, async ($, e, next) => {

Execute commands · line30 lineplugin/hooks/app/index.tsconst match = /^mcp__[\w-]*autoresearch[\w-]*__(init|run|log)_experiment$/.exec(served);

Execute commands · line119 lineplugin/hooks/app/index.tsif (name === "init_experiment") answer = await executeInit(ctx, input as unknown as InitParams);

Execute commands · line120 lineplugin/hooks/app/index.tselse if (name === "run_experiment") answer = await executeRun(ctx, input as unknown as RunParams, toolUseId, signal);

Execute commands · line121 lineplugin/hooks/app/index.tselse answer = await executeLog(ctx, input as unknown as LogParams);

Execute commands · line79 lineplugin/hooks/upstream/experiment-core.tswhile ((match = regex.exec(output)) !== null) {

Execute commands · line73 lineplugin/hooks/app/export.tsconst child = host.spawn(

Execute commands · line24 lineplugin/hooks/app/tools/init.tsexport async function executeInit(ctx: Ctx, params: InitParams): Promise<ToolAnswer> {

Execute commands · line87 lineplugin/hooks/app/tools/run.tsexport async function executeRun(

Execute commands · line193 lineplugin/hooks/app/tools/run.tsconst child = host.spawn(wrapperArgv(host, timeout / 1000, timeoutMarker, fullLogPath, params.command), {

Execute commands · line334 lineplugin/hooks/app/tools/run.tsconst child = host.spawn(

Execute commands · line54 lineplugin/hooks/app/tools/log.tsexport async function executeLog(ctx: Ctx, params: LogParams): Promise<ToolAnswer> {

Execute commands · line83 lineplugin/hooks/ui/styled.tsconst marker = /^38;2;1;2;(\d+)$/.exec(params);

autoresearch

About this mod

Installation

autoresearch

Similar projects

ruflo-browser

assumption-ledger

hermitd-mod-tests