← all repositories
psi-oss/get-physics-done

An AI research advisor that actually wants you to check its homework

GPD bolts a structured physics-research workflow onto Claude, Codex, Gemini, and other AI runtimes so the model doesn't just hallucinate your paper.

869 stars Python AgentsDomain Apps
get-physics-done
Not currently ranked — collecting fresh signals.
star history

What it does

Get Physics Done is a command package that installs into existing AI coding assistants (Claude Code, Codex, Gemini CLI, etc.). It turns a raw research question into a managed pipeline: scope, plan, derive, verify, and package results. The README is explicit that this is not a standalone app—it’s a layer of discipline on top of chatty agents.

The interesting bit

The design philosophy is deliberately adversarial. GPD is built to “favor scientific rigor and critical thinking over agreeability,” with explicit tracking of failed lookups, missing evidence, and dead ends rather than confident confabulation. Supervised mode acts like an advisor checking a grad student’s work; you graduate to less hand-holding only after the model earns trust on your specific problem.

Key highlights

  • Multi-runtime support: Claude Code, Codex, Gemini CLI, GitHub Copilot CLI, OpenCode
  • Structured command ladder: help → start → tour → new-project/map-research → resume-work
  • Research memory persists across sessions via resume-work
  • Two modes: Supervised (frequent checkpoints) and Balanced (less oversight)
  • Apache 2.0, from Physical Superintelligence PBC (PSI)

Caveats

  • Requires Node.js 20+, Python 3.11+, and an existing supported runtime; the installer doesn’t provide model access or API credits
  • The README notes GPD “does not install your runtime or provide model access, billing, or API credits”
  • 823 stars is modest traction for the hype around agentic AI; unclear how battle-tested the verification layer is in practice

Verdict

Worth a look if you’re a physicist (or adjacent researcher) already using Claude/Codex/Gemini and tired of coaxing coherent multi-step analysis from a chat window. Skip it if you want a fully contained tool or don’t already have runtime access and API budget sorted.

Frequently asked

What is psi-oss/get-physics-done?
GPD bolts a structured physics-research workflow onto Claude, Codex, Gemini, and other AI runtimes so the model doesn't just hallucinate your paper.
Is get-physics-done open source?
Yes — psi-oss/get-physics-done is an open-source project tracked on heatdrop.
What language is get-physics-done written in?
psi-oss/get-physics-done is primarily written in Python.
How popular is get-physics-done?
psi-oss/get-physics-done has 869 stars on GitHub.
Where can I find get-physics-done?
psi-oss/get-physics-done is on GitHub at https://github.com/psi-oss/get-physics-done.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.