OpenResearch: Parallel agents for research and experiments
A local workspace for Claude Code, Codex, and OpenCode to run parallel research while Git preserves experiment lineage and evidence.
GitHub alphaXiv/OpenResearch Updated 2026-09-12 Branch main Stars 1.3K Forks 94
Rust TypeScript Research automation Claude Code Codex OpenCode macOS/Linux SQLite

🧭 Decision Guide

Try it if you

  • You want Claude Code, Codex, or OpenCode to explore multiple research directions at the same time.
    The README section “Built for research agents” describes an independent agent session and isolated git worktree for each direction.
  • Your experiments need to preserve commit lineage and connect logs, diffs, results, and artifacts.
    The README sections “Reproducible experiments” and “Evidence in context” describe experiment trees, immutable archives, and linked evidence.
  • You need to run the same committed snapshot locally, over SSH, on Slurm, Kubernetes, or Ray.
    The README section “Run anywhere” lists these environments and says publishing the repository is not required.
  • You want code and experiments to remain on your machine by default, with workspace data stored in local SQLite.
    The README section “Local by default” says the workspace runs on 127.0.0.1 and uses a local SQLite store.

Skip it if you

  • You need to expose the service on a shared remote host with application-level authentication between users.
    The README section “Run anywhere” explicitly says the remote service has no application-level authentication.
  • Your environment is Windows and you cannot accept beta support or installing Git for Windows.
    The README section “Get started” says Windows support is still in beta and requires Git for Windows.
  • Your organization prohibits official release builds from sending any usage analytics.
    The README section “Usage analytics” says official release builds send opt-out, coarse usage events by default.
  • You only need to run a one-off script and do not need agent sessions or an experiment tree for Claude Code, Codex, or OpenCode.
    The README’s core functionality centers on research agents, parallel exploration, and reproducible experiments.

Requirements

  • On macOS or Linux, install the CLI using the method in the README; on Windows, install it from Releases.
  • Windows requires Git for Windows, and docs/windows.md should be read first; Windows support is still in beta.
  • For connecting OpenCode to LM Studio, oMLX, Ollama, or a custom endpoint, refer to docs/local-models.md.
  • For remote GPU usage, SSH can be used; the README example is orx up --remote user@host.
  • For a local workspace, the README specifies 127.0.0.1:4791 by default and a local SQLite store.

First step (verbatim from README)

orx up

Watch out

  • When running orx up --remote, the remote service binds to loopback but has no application-level authentication.
    The README section “Run anywhere” explicitly says other users can reach the remote service.
  • Official release builds send coarse events associated with a random installation ID.
    The README section “Usage analytics”; telemetry can be disabled with orx telemetry off.
  • Do not treat Windows beta support as equivalent to the macOS/Linux path.
    The README section “Get started” directly labels Windows support as still in beta.
  • Remote execution depends on SSH configuration, host, and port; the README only states that aliases and custom ports are supported.
    The README section “Run anywhere”.

Alternatives

  • Git worktree + shell scripts:More direct when you only need Git worktrees and scripts to orchestrate a small number of experiments, without agent sessions, experiment trees, or the OpenResearch dashboard.
    General domain knowledge
  • Using Claude Code, Codex, or OpenCode alone:Simpler when you only need one coding agent for a single task and do not need OpenResearch’s parallel research and experiment archival.
    README sections “Built for research agents” and “CLI and agent integration”

Not stated in the README

  • The README does not specify supported version ranges for Claude Code, Codex, or OpenCode.
  • The README does not specify minimum versions for Rust, Node.js, Python, or other runtimes.
  • The README does not state limits on parallel agent counts, resource consumption, or experiment performance.
  • The README does not state pricing, regions, quotas, or data-retention policies for managed OpenResearch compute.
  • The README does not explain the exact authentication mechanism of the local dashboard at 127.0.0.1:4791.
  • The README does not provide configuration steps or capability differences for Slurm, Kubernetes, Ray, Modal, or Tinker.
  • The README does not describe the changes or upgrade compatibility between v0.2.0 and earlier versions.

💡 Deep Analysis

6
Yes I already use Claude Code, Codex, or OpenCode and want multiple agents to modify code, run experiments, and compare hypotheses independently. Is OpenResearch suitable for replacing my manually managed experiment branches?
For: A research engineer using Claude Code, Codex, or OpenCode to compare multiple algorithmic directions in parallel while preserving a Git-based evidence trail

Yes, because it directly combines agent sessions, isolated worktrees, and experiment lineage into a parallel research workflow.

  • Each research direction receives an independent agent session and isolated Git worktree, which supports parallel hypothesis exploration.
  • The experiment tree is Git-native, and every run receives an immutable archive of its recorded commit, allowing results to be traced to code.
  • Claude Code, Codex, and OpenCode are explicitly supported, and the harness and model can be selected per session.
  • Logs, diffs, files, results, and artifacts are tied to the run that produced them rather than only storing final metrics.

The README does not specify large-scale concurrency limits, recovery behavior after agent failures, or any guarantee that agent-generated hypotheses and interpretations are scientifically correct.

  • Built for research agents: "Give each research direction an independent agent session and isolated git worktree."
  • Built for research agents: "Track variants in a git-native experiment tree; every run receives an immutable archive of its recorded commit."
  • Built for research agents: "Use Claude Code, Codex, or OpenCode"
  • Built for research agents: "Keep logs, diffs, files, results, and artifacts tied to the work that produced them."
orx install-skills
Not stated in the README:The maximum number of parallel agents, queue behavior, and failure retry policy are not specified in the README.;The README does not explain how conflicts are handled when multiple worktrees modify the same file.
Yes I debug models locally and then submit experiments to SSH hosts, Slurm, Kubernetes, or Ray. Can OpenResearch avoid making me copy code and experiment configuration separately for each compute environment?
For: A machine-learning research engineer who needs to move the same research code from a local environment to SSH hosts, Slurm, Kubernetes, or Ray

Yes, provided those environments already have usable Git, runtimes, dependencies, and access configuration; the project explicitly supports moving execution from a common committed snapshot.

  • The README lists local execution, SSH, Slurm, Kubernetes, Ray, Hugging Face Jobs, Modal, Tinker, and managed compute.
  • “The same committed source snapshot” can run across these environments, and publishing the repository is not required.
  • orx up --remote user@host supports running the workspace next to a remote GPU while using a browser locally.
  • This reduces code-copying between local development and remote experiments, but it does not automatically prepare remote dependencies or eliminate runtime differences.

The remote service binds to loopback but has no application-level authentication. On a shared SSH host, other users on that host may reach it, so it should not be treated as a public-facing secure service.

  • Run anywhere: "The same committed source snapshot can run locally, over SSH, or on Slurm, Kubernetes, Ray, Hugging Face Jobs, Modal, Tinker, and managed OpenResearch compute."
  • Run anywhere: "Publishing the repository is not required."
  • Run anywhere: "orx up --remote user@host"
  • Run anywhere: "The remote service binds to loopback and has no application-level authentication"
orx up --remote user@host
Not stated in the README:The README does not specify dependencies, credentials, container images, or runtime versions required by each backend.;Task cancellation, queue state, failure recovery, and cross-backend parameter mapping are not described.
It depends My project contains unpublished code and local data, and I want to run agents through LM Studio, oMLX, Ollama, or a custom endpoint. Does OpenResearch fit my local-ownership and replaceable-model requirements?
For: A researcher handling unpublished code and local data who wants to use LM Studio, oMLX, Ollama, or a custom endpoint without routinely uploading the project

It depends: local storage and local model connectivity fit the requirement, but once external models, managed compute, or organization services are used, the data boundary depends on each endpoint and service configuration.

  • OpenResearch runs on 127.0.0.1 by default and uses local SQLite for projects, conversations, experiments, runs, logs, code, and artifacts.
  • The README states that creating a project or launching a run does not publish code; accounts are used for organization and managed-compute capabilities.
  • OpenCode can connect to LM Studio, oMLX, Ollama, or a custom endpoint, so the agent and model are not locked to one provider.
  • Official release builds send opt-out coarse usage events. Although they exclude code, prompts, file contents, and paths, strict compliance environments should still disable them.

The README does not specify retention, training use, encryption, or the exact data sent to each external model endpoint during agent execution.

  • Local by default: "OpenResearch runs on 127.0.0.1 with a local SQLite store."
  • Local by default: "Creating a project or launching a run does not publish your code."
  • Get started: "To use LM Studio, oMLX, Ollama, or a custom endpoint with OpenCode"
  • Usage analytics: "Official release builds send opt-out, coarse usage events"
orx telemetry off
Not stated in the README:The README does not specify the exact API compatibility range for LM Studio, oMLX, Ollama, and custom endpoints.;Data retention, training policies, and request encryption for external model providers are not documented.;The transfer boundary for agent prompts, code snippets, and experiment data across different call paths is not listed.
It depends My workstation runs Windows and already has Git for Windows. I want to manage experiments through the OpenResearch desktop app or CLI. Is it suitable as my everyday research workspace now?
For: An individual researcher on Windows who relies on Git for Windows and wants to manage research experiments through the desktop app or CLI

It depends: Windows is supported, but the README explicitly marks support as beta, so it is better suited to an individual researcher who can tolerate platform-compatibility risk than to a stability-critical workspace.

  • Windows installation comes from Releases, and the README requires reading the Windows notes first.
  • Git for Windows is required, which matches the project’s reliance on Git worktrees, commits, and experiment trees.
  • macOS/Linux can use the install script and orx up to start the local dashboard; Windows does not receive the same level of startup detail.
  • The latest release is v0.2.0 and the project has five releases, indicating an early-stage product whose Windows behavior may change.

The README does not specify complete Windows CLI coverage, Shell requirements, path compatibility, the remote SSH toolchain, or desktop-versus-CLI feature differences.

  • Get started: "On Windows, install from Releases and read the Windows notes first — Git for Windows is required, and support is still in beta."
  • Get started: "install the CLI on macOS or Linux"
  • Project data: latest_release is v0.2.0 and release_count is 5
Not stated in the README:The specific limitations, known issues, and supported shells in the Windows notes are not included in the provided README excerpt.;A compatibility matrix for the desktop app, CLI, Git worktrees, and remote mode on Windows is not provided.
It depends I want code, conversations, experiments, and artifacts to remain local by default while using managed OpenResearch compute. Can OpenResearch provide both local data control and managed compute?
For: A researcher who wants to keep code, conversations, experiments, run logs, and artifacts in a local SQLite workspace while using managed OpenResearch compute

It depends: the project provides local-first workspace storage, but when managed compute is used, the actual scope of code, data, and logs sent remotely depends on the service implementation and configuration.

  • OpenResearch uses local SQLite for projects, conversations, experiments, runs, logs, code, and artifacts.
  • The README says creating a project or launching a run does not publish code, while accounts are mainly used for organizations and managed-compute capabilities.
  • The execution layer supports local execution, user-owned infrastructure, and managed OpenResearch compute, so local workspace management and hosted execution can be combined.
  • The same committed source snapshot can run across multiple environments without publishing the repository, preserving commit-level traceability.

However, the README does not document managed-job upload scope, retention period, encryption, region, deletion behavior, or residual data after failed jobs. “Local-first” alone is therefore insufficient for a specific compliance decision.

  • Local by default: "local SQLite store" and storage of "projects, conversations, experiments, runs, logs, code, and artifacts"
  • Local by default: "Creating a project or launching a run does not publish your code."
  • Built for research agents: "Run locally, on your own infrastructure, or with managed OpenResearch compute."
  • Run anywhere: "Publishing the repository is not required."
orx up
Not stated in the README:The data-upload, caching, log-retention, encryption, and deletion policies for managed OpenResearch compute are not documented.;Private networking, region selection, data residency, and organization-level access control for managed jobs are not specified.;Backup, recovery, migration, and multi-user concurrency behavior for local SQLite are not documented.
Yes We already use Claude Code, Codex, or OpenCode for experiment code and want one CLI workflow for paper discovery, experiment execution, and log inspection. Can OpenResearch cover that path from literature to experiments?
For: A small machine-learning team that wants CLI-based paper discovery, experiment execution, and log tracking while integrating Claude Code, Codex, or OpenCode

Yes for the engineering workflow, but the README does not justify treating it as a complete literature-management or systematic-review platform.

  • The CLI includes orx discover keyword <query> and orx paper <arxiv-id-or-doi>, showing that paper discovery and paper entry points are included.
  • orx projects, orx runs <project-id>, orx logs <run-id>, and orx exp run <experiment-id> cover project, run, log, and experiment operations.
  • orx install-skills installs OpenResearch skills into supported coding agents, which fits teams already using Claude Code, Codex, or OpenCode.
  • The local dashboard launched by orx up provides a visual workspace, while the CLI supports scripting and remote operation.

However, the README does not confirm literature metadata quality, full-text retrieval, citation export, systematic-review workflows, or a multi-user permission model, so those areas should not be assumed to be solved.

  • CLI and agent integration: "orx projects", "orx runs <project-id>", "orx logs <run-id>", and "orx exp run <experiment-id>"
  • CLI and agent integration: "orx discover keyword <query>", "orx paper <arxiv-id-or-doi>"
  • CLI and agent integration: "orx install-skills"
  • Get started: "orx up opens the local dashboard"
orx install-skills
Not stated in the README:The covered literature sources, ranking quality, full-text access, and citation-export capabilities are not specified.;Team collaboration, permissions, review workflows, and SQLite concurrency limits are not documented.

✨ Highlights

  • Supports parallel exploration with Claude Code, Codex, and OpenCode
  • Experiment trees track commit lineage and create immutable archives
  • Runs locally or on SSH, Slurm, Kubernetes, and Ray
  • Windows support is still beta and requires Git for Windows

🔧 Engineering

  • orx up starts the local dashboard at 127.0.0.1:4791
  • autoresearch automates proposals, code changes, experiments, and evidence checks
  • Each research direction uses an independent agent session and isolated git worktree
  • The same committed snapshot can run locally, over SSH, Slurm, and managed compute

⚠️ Risks

  • The remote service has no application-level authentication, so other users on the host can reach it
  • The Windows version is still beta and requires reading docs/windows.md first
  • Official release builds send coarse usage events by default
  • The project has 6 contributors, 5 releases, and 10 recent commits

👥 For who?

  • Developers who need Claude Code, Codex, or OpenCode for parallel research
  • Teams using local or remote GPUs with Slurm, Kubernetes, or Ray
  • Individual researchers who want projects, experiments, logs, and artifacts kept with SQLite and git