# OpenResearch | alphaXiv | Knowledge Base | Instagit

Run parallel research agents with any model

GitHub Stars: 1.7k

Repository: https://github.com/alphaXiv/OpenResearch

---

## Articles

### [How to Tunnel the Orx Dashboard Service to a Remote SSH Host](/alphaXiv/OpenResearch/how-can-i-tunnel-orx-dashboard-service-to-remote-ssh-host)

Easily tunnel the Orx dashboard service to a remote SSH host using automatic or manual methods. Learn how to access your Orx dashboard securely from anywhere.

- Tags: how-to-guide
- Published: 2026-09-13

### [How orx up Starts the Local Dashboard and API in OpenResearch](/alphaXiv/OpenResearch/how-does-orx-up-start-local-dashboard-and-api)

Discover how orx up starts the local dashboard and API in OpenResearch. Learn about TCP listeners, LLM hosts, and Axum HTTP servers for seamless operation.

- Tags: how-to-guide
- Published: 2026-09-13

### [How to Install Reusable Agent Skills with `orx`: A Complete Guide](/alphaXiv/OpenResearch/how-do-i-install-reusable-agent-skills-with-orx)

Learn how to install reusable agent skills with orx. This guide shows how the orx install-skills command enables agents to discover and invoke the orx command automatically.

- Tags: how-to-guide
- Published: 2026-09-13

### [How the plan_gate Module Controls Agent Permissions in orx](/alphaXiv/OpenResearch/how-does-plan-gate-module-control-agent-permissions-in-orx)

Discover how the plan_gate module controls agent permissions in orx. Learn about its allow-list policy for read-only operations and user approval for destructive actions in Claude's --permission-mode plan.

- Tags: internals
- Published: 2026-09-13

### [Where to Find Agent Harnesses for Different Coding Agents in orx](/alphaXiv/OpenResearch/where-can-i-find-agent-harnesses-for-different-coding-agents-in-orx)

Discover agent harnesses for Claude Code, OpenCode, Cursor, and Codex within the alphaXiv/OpenResearch repository. Find them in the src/local/harness/ directory.

- Tags: how-to-guide
- Published: 2026-09-13

### [How orx Handles Python Streaming for CPython Jobs: Real-Time Output Across Backends](/alphaXiv/OpenResearch/how-does-orx-handle-python-streaming-for-cpython-jobs)

orx ensures real-time Python streaming for CPython jobs by setting PYTHONUNBUFFERED and PYTHONIOENCODING across all backends like Modal, Slurm, Kubernetes, and more. Get instant stdout/stderr.

- Tags: how-to-guide
- Published: 2026-09-13

### [Which Backend Kinds Does orx Support? A Complete Guide to OpenResearch Compute Backends](/alphaXiv/OpenResearch/which-backend-kinds-are-supported-by-orx)

Discover the nine backend kinds supported by orx: hf_job, k8s_job, modal_job, slurm_job, ssh_job, ray_job, openresearch_job, local_job, and tinker_job. Explore the complete guide to OpenResearch compute backends.

- Tags: how-to-guide
- Published: 2026-09-13

### [What Is the BackendDescriptor in orx and How Is It Serialized?](/alphaXiv/OpenResearch/what-is-backenddescriptor-in-orx-and-how-is-it-serialized)

Understand the BackendDescriptor in orx, a data structure for backend job metadata. Learn how it serializes to JSON using serde for SQLite integration in this technical guide.

- Tags: internals
- Published: 2026-09-13

### [StoredRun, LocalExperiment, and LocalProject Types in orx: A Complete Guide](/alphaXiv/OpenResearch/what-are-storedrun-localexperiment-localproject-types-in-orx)

Explore StoredRun LocalExperiment and LocalProject types in orx for efficient local research artifact management. Understand their roles in persistence and organization.

- Tags: how-to-guide
- Published: 2026-09-13

### [How orx Uses a Lifecycle Lock for Atomic Destructive Operations](/alphaXiv/OpenResearch/how-does-orx-use-lifecycle-lock-for-destructive-operations)

Discover how orx utilizes a file-based lifecycle lock with fd_lock RwLock for exclusive and atomic destructive operations, safeguarding persistent state from concurrent mutations.

- Tags: internals
- Published: 2026-09-13

### [ORX Data Directory Resolution Order: How OpenResearch Locates Your Data](/alphaXiv/OpenResearch/what-is-resolution-order-for-orx-data-directory)

Understand the ORX data directory resolution order. Learn how OpenResearch finds your data by checking ORX_DATA_DIR, XDG_DATA_HOME, and your home directory.

- Tags: how-to-guide
- Published: 2026-09-13

### [Where Are orx Run Logs Stored? Log File Paths in OpenResearch](/alphaXiv/OpenResearch/where-are-orx-run-logs-stored)

Discover where orx run logs are stored in alphaXiv OpenResearch. Find log file paths generated by the log path helper function in src/store.rs.

- Tags: how-to-guide
- Published: 2026-09-13

### [How orx Stores Its Local SQLite Database: File Paths, WAL Mode, and Schema](/alphaXiv/OpenResearch/how-is-local-sqlite-database-stored-by-orx)

Discover how orx stores its local SQLite database in orx.db. Learn about file paths, WAL mode, and schema for efficient data management with the alphaXiv OpenResearch CLI.

- Tags: internals
- Published: 2026-09-13

### [What Data Does the RunLog Struct Contain in OpenResearch?](/alphaXiv/OpenResearch/what-data-does-runlog-struct-contain)

Discover the eight fields within the RunLog struct in alphaXiv/OpenResearch. Understand how it stores raw log bytes and pagination metadata for efficient data management.

- Tags: api-reference
- Published: 2026-09-13

### [What Information Does the Run Struct in orx Store? A Complete Field Guide](/alphaXiv/OpenResearch/what-information-does-run-struct-in-orx-store)

Discover what the Run struct in orx stores. Learn how id, experiment_id, status, commit_sha, duration_secs, updated_display, and result_markdown create readable CLI output for experiment tracking.

- Tags: api-reference
- Published: 2026-09-13

### [How the Plane Abstraction in OpenResearch Shares Data Structures Across the CLI](/alphaXiv/OpenResearch/how-does-plane-abstraction-in-src-plane-rs-share-data-structures)

Learn how the Plane abstraction in alphaXiv/OpenResearch shares data structures like Run, RunLog, and ProjectEdit across its CLI. Discover its single source of truth.

- Tags: internals
- Published: 2026-09-13

### [Hidden Internal ORX Commands: How the OpenResearch CLI Manages Background Services](/alphaXiv/OpenResearch/what-are-hidden-internal-orx-commands-used-for)

Discover hidden internal orx commands for the OpenResearch CLI. Learn how they manage background services like permission checks, session management, and state updates via undocumented API endpoints.

- Tags: internals
- Published: 2026-09-13

### [orx CLI Subcommands: Complete Guide to OpenResearch Command-Line Tools](/alphaXiv/OpenResearch/what-are-notable-user-facing-subcommands-in-orx-cli)

Explore the orx CLI's essential user-facing subcommands like login, exp, compute, and discover. This guide covers authentication, experiment management, and GPU instance control for OpenResearch.

- Tags: how-to-guide
- Published: 2026-09-13

### [How to Permanently Disable Telemetry for `orx`](/alphaXiv/OpenResearch/how-do-i-permanently-disable-telemetry-for-orx)

Permanently disable orx telemetry with a simple command. Learn how to write the persistent opt-out flag to your user configuration file for complete privacy.

- Tags: how-to-guide
- Published: 2026-09-13

### [How to Disable Telemetry for a Single orx Command Invocation](/alphaXiv/OpenResearch/how-can-i-disable-telemetry-for-single-orx-command-invocation)

Learn how to disable telemetry for a single orx command invocation using the --no-telemetry flag or ORX_TELEMETRY_ENV=off environment variable. Control data collection easily.

- Tags: how-to-guide
- Published: 2026-09-13

### [How the orx CLI Uses the clap-derive Command Tree in OpenResearch](/alphaXiv/OpenResearch/how-does-clap-derive-command-tree-work-in-orx)

Discover how the orx CLI leverages clap-derive for a type-safe command tree, dispatching commands to handler modules for efficient Rust CLI development.

- Tags: internals
- Published: 2026-09-13

### [Understanding the Role of src/main.rs in the OpenResearch CLI](/alphaXiv/OpenResearch/what-is-the-role-of-src-main-rs-in-openresearch-cli)

Discover the crucial role of src/main.rs in the OpenResearch CLI. Learn how it bootstraps the async runtime, parses arguments, and routes commands for efficient operation.

- Tags: internals
- Published: 2026-09-13

### [OpenResearch CLI (`orx`) Internal Structure: A Deep Dive into the Rust Architecture](/alphaXiv/OpenResearch/how-is-openresearch-cli-orx-structured-internally)

Explore the internal structure of the OpenResearch CLI orx. Discover its Rust architecture, layered design, and separation of local and remote operations for efficient workflow management.

- Tags: deep-dive
- Published: 2026-09-13