{"_id":"pi-autoresearch","_rev":"10-05432dec22db0ee3e346775d8851d8ef","name":"pi-autoresearch","dist-tags":{"latest":"1.7.0"},"versions":{"1.1.0":{"name":"pi-autoresearch","version":"1.1.0","keywords":["pi-package","pi","pi-extension","autoresearch","experiment","optimization","benchmark","coding-agent"],"author":{"name":"David Cortés","email":"477473+davebcn87@users.noreply.github.com"},"license":"MIT","_id":"pi-autoresearch@1.1.0","maintainers":[{"name":"davebcn87","email":"david.cortes.18@gmail.com"}],"homepage":"https://github.com/davebcn87/pi-autoresearch#readme","bugs":{"url":"https://github.com/davebcn87/pi-autoresearch/issues"},"pi":{"skills":["./skills"],"extensions":["./extensions"]},"dist":{"shasum":"7bf5d6bfc2e3d9a2d1f52c7ed6b43ab7d8cde50b","tarball":"https://registry.npmjs.org/pi-autoresearch/-/pi-autoresearch-1.1.0.tgz","fileCount":24,"integrity":"sha512-B1/5P+VSM0MYAv8bSJJK8tenNtnr8VrnLsqMASUXvsR+LVUjeF6aV14lFZ3ryipLfpJVRxC0mVPyCcH40/72Zw==","signatures":[{"sig":"MEUCIQCZdxAU4IIaFJYMVCHcTXaHX4cT+oguYvw4od6A+3yWlAIgA3FIOqNKn8K7kcaKYvyFF+mbPmVnTGROWb1l5U/AyGw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":245865},"type":"module","engines":{"node":">=22"},"gitHead":"7f30fad32c3b8b745f4ce82f0addccc59f253d12","scripts":{"test":"node --experimental-strip-types --test tests/*.test.mjs"},"_npmUser":{"name":"davebcn87","email":"david.cortes.18@gmail.com"},"repository":{"url":"git+https://github.com/davebcn87/pi-autoresearch.git","type":"git"},"_npmVersion":"11.13.0","description":"Autonomous experiment loop for pi — run, measure, keep or discard. Inspired by karpathy/autoresearch.","directories":{},"_nodeVersion":"24.1.0","_hasShrinkwrap":false,"packageManager":"pnpm@10.28.2","devDependencies":{"@sinclair/typebox":"^0.34.41","@mariozechner/pi-ai":"^0.65.0","@mariozechner/pi-tui":"^0.65.0","@mariozechner/pi-coding-agent":"^0.65.0"},"peerDependencies":{"@sinclair/typebox":"*","@mariozechner/pi-ai":"*","@mariozechner/pi-tui":"*","@mariozechner/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-autoresearch_1.1.0_1777368392970_0.5603985523379482","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"pi-autoresearch","version":"1.1.1","keywords":["pi-package","pi","pi-extension","autoresearch","experiment","optimization","benchmark","coding-agent"],"author":{"name":"David Cortés","email":"477473+davebcn87@users.noreply.github.com"},"license":"MIT","_id":"pi-autoresearch@1.1.1","maintainers":[{"name":"davebcn87","email":"david.cortes.18@gmail.com"}],"homepage":"https://github.com/davebcn87/pi-autoresearch#readme","bugs":{"url":"https://github.com/davebcn87/pi-autoresearch/issues"},"pi":{"skills":["./skills"],"extensions":["./extensions"]},"dist":{"shasum":"af2b259bdb123a49d77c96e9772e57dd75e8960e","tarball":"https://registry.npmjs.org/pi-autoresearch/-/pi-autoresearch-1.1.1.tgz","fileCount":24,"integrity":"sha512-70w7TzHTkflhi0CsREg+VekH+OIbEe+Qma8PhX/SATx6pBcV2zloQEEioT3HnnEqeBfEIoNZM7po7/gK5cR5Tw==","signatures":[{"sig":"MEQCIE7x8xnas2+02ax3s1ee/hCVFYyNQXBXDm/xxKDpHhueAiA4AVSX1RBbydhCSq1+rhf8pV56zhj4qYATtpaIDzz5Zw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/pi-autoresearch@1.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":245962},"type":"module","engines":{"node":">=22"},"gitHead":"df57283dfbf678a8f39360a6070f080358a6ac3e","scripts":{"test":"node --experimental-strip-types --test tests/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:33872b57-bf64-4fe6-8dfb-14665dcb5756"}},"repository":{"url":"git+https://github.com/davebcn87/pi-autoresearch.git","type":"git"},"_npmVersion":"11.13.0","description":"Autonomous experiment loop for pi — run, measure, keep or discard. Inspired by karpathy/autoresearch.","directories":{},"_nodeVersion":"22.22.2","_hasShrinkwrap":false,"packageManager":"pnpm@10.28.2","devDependencies":{"@sinclair/typebox":"^0.34.41","@mariozechner/pi-ai":"^0.65.0","@mariozechner/pi-tui":"^0.65.0","@mariozechner/pi-coding-agent":"^0.65.0"},"peerDependencies":{"@sinclair/typebox":"*","@mariozechner/pi-ai":"*","@mariozechner/pi-tui":"*","@mariozechner/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-autoresearch_1.1.1_1777369550815_0.49533467310202317","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"pi-autoresearch","version":"1.2.0","keywords":["pi-package","pi","pi-extension","autoresearch","experiment","optimization","benchmark","coding-agent"],"author":{"name":"David Cortés","email":"477473+davebcn87@users.noreply.github.com"},"license":"MIT","_id":"pi-autoresearch@1.2.0","maintainers":[{"name":"davebcn87","email":"david.cortes.18@gmail.com"}],"homepage":"https://github.com/davebcn87/pi-autoresearch#readme","bugs":{"url":"https://github.com/davebcn87/pi-autoresearch/issues"},"pi":{"skills":["./skills"],"extensions":["./extensions"]},"dist":{"shasum":"d091e89a3e4fd30c75007592c77f097542033618","tarball":"https://registry.npmjs.org/pi-autoresearch/-/pi-autoresearch-1.2.0.tgz","fileCount":23,"integrity":"sha512-VkJK3Rx1980xXXLgQfcbNIEtLFNDjf8euj56MQJJp08lF0W0xVOgKRU5NJDzRR+mN/RUCaqzSmTbJqgFA7O6/g==","signatures":[{"sig":"MEUCIQCWAk1eaKYWnytJbqS0jsXTn4/k3X68yDS8mZHWgyEmaQIgdQsgwzPNNTWf4Lhff8wriN5bWfFJdM/UtdyeY4amMaw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/pi-autoresearch@1.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":244122},"type":"module","engines":{"node":">=22"},"gitHead":"37a611f460f07be353c86dc4596542c03946a2a7","scripts":{"test":"node --experimental-strip-types --test tests/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:33872b57-bf64-4fe6-8dfb-14665dcb5756"}},"repository":{"url":"git+https://github.com/davebcn87/pi-autoresearch.git","type":"git"},"_npmVersion":"11.13.0","description":"Autonomous experiment loop for pi — run, measure, keep or discard. Inspired by karpathy/autoresearch.","directories":{},"_nodeVersion":"22.22.2","_hasShrinkwrap":false,"packageManager":"pnpm@10.28.2","devDependencies":{"@sinclair/typebox":"^0.34.41","@mariozechner/pi-ai":"^0.65.0","@mariozechner/pi-tui":"^0.65.0","@mariozechner/pi-coding-agent":"^0.65.0"},"peerDependencies":{"@sinclair/typebox":"*","@mariozechner/pi-ai":"*","@mariozechner/pi-tui":"*","@mariozechner/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-autoresearch_1.2.0_1777385603122_0.397118644008833","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"pi-autoresearch","version":"1.3.0","keywords":["pi-package","pi","pi-extension","autoresearch","experiment","optimization","benchmark","coding-agent"],"author":{"name":"David Cortés","email":"477473+davebcn87@users.noreply.github.com"},"license":"MIT","_id":"pi-autoresearch@1.3.0","maintainers":[{"name":"davebcn87","email":"david.cortes.18@gmail.com"}],"homepage":"https://github.com/davebcn87/pi-autoresearch#readme","bugs":{"url":"https://github.com/davebcn87/pi-autoresearch/issues"},"pi":{"skills":["./skills"],"extensions":["./extensions"]},"dist":{"shasum":"837b33f7a88ef6d01082494a877dec37d6f0c9bc","tarball":"https://registry.npmjs.org/pi-autoresearch/-/pi-autoresearch-1.3.0.tgz","fileCount":24,"integrity":"sha512-Q3SBQCBD/tAvbtM6i7woxV7X+Yz8NcxRIeB7dnjNnSUnuRIXPBoI3OnIC5ku3ryy5XCmZs8QXPtDglL2vWsX5w==","signatures":[{"sig":"MEUCIBRXp2mdItEGbGySF9a7kMLkRcITrEQ1485plOiEHj0EAiEAjYDFw7cPBPda2YQWNf7JeisPZhf5sUhEnJBKysz/tEQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/pi-autoresearch@1.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":254272},"type":"module","engines":{"node":">=22"},"gitHead":"376ccc62d88345e84d524486699378eaf006f838","scripts":{"test":"node --experimental-strip-types --test tests/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:33872b57-bf64-4fe6-8dfb-14665dcb5756"}},"repository":{"url":"git+https://github.com/davebcn87/pi-autoresearch.git","type":"git"},"_npmVersion":"11.13.0","description":"Autonomous experiment loop for pi — run, measure, keep or discard. Inspired by karpathy/autoresearch.","directories":{},"_nodeVersion":"22.22.2","_hasShrinkwrap":false,"packageManager":"pnpm@10.28.2","devDependencies":{"@sinclair/typebox":"^0.34.41","@mariozechner/pi-ai":"^0.65.0","@mariozechner/pi-tui":"^0.65.0","@mariozechner/pi-coding-agent":"^0.65.0"},"peerDependencies":{"@sinclair/typebox":"*","@mariozechner/pi-ai":"*","@mariozechner/pi-tui":"*","@mariozechner/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-autoresearch_1.3.0_1777459479732_0.7854248975920444","host":"s3://npm-registry-packages-npm-production"}},"1.4.0":{"name":"pi-autoresearch","version":"1.4.0","keywords":["pi-package","pi","pi-extension","autoresearch","experiment","optimization","benchmark","coding-agent"],"author":{"name":"David Cortés","email":"477473+davebcn87@users.noreply.github.com"},"license":"MIT","_id":"pi-autoresearch@1.4.0","maintainers":[{"name":"davebcn87","email":"david.cortes.18@gmail.com"}],"homepage":"https://github.com/davebcn87/pi-autoresearch#readme","bugs":{"url":"https://github.com/davebcn87/pi-autoresearch/issues"},"pi":{"skills":["./skills"],"extensions":["./extensions"]},"dist":{"shasum":"20c2eb974f5c45ddfcaa1651066925354e3b73b6","tarball":"https://registry.npmjs.org/pi-autoresearch/-/pi-autoresearch-1.4.0.tgz","fileCount":25,"integrity":"sha512-8PHfX/MGS/IfrLoE52mC8p9aExMkxQ1keefVVSa3zcXrdT4/Za61b1skBXOzo3uncVYDLYerm86LRK5wfFbqpw==","signatures":[{"sig":"MEUCICB0d8AXcP0CyYLL5/mXgZLT23oxISVw+zgMR4o8CoCcAiEA9uWkWwGPpV4INM33T5bb64tdzwzN1zO7wvEa1FdHQjs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/pi-autoresearch@1.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":259173},"type":"module","engines":{"node":">=22"},"gitHead":"84232861a09e753f63bceda46852f0ddbb4c9afd","scripts":{"test":"node --experimental-strip-types --test tests/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:33872b57-bf64-4fe6-8dfb-14665dcb5756"}},"repository":{"url":"git+https://github.com/davebcn87/pi-autoresearch.git","type":"git"},"_npmVersion":"11.13.0","description":"Autonomous experiment loop for pi — run, measure, keep or discard. Inspired by karpathy/autoresearch.","directories":{},"_nodeVersion":"22.22.2","_hasShrinkwrap":false,"packageManager":"pnpm@10.28.2","devDependencies":{"@sinclair/typebox":"^0.34.41","@mariozechner/pi-ai":"^0.65.0","@mariozechner/pi-tui":"^0.65.0","@mariozechner/pi-coding-agent":"^0.65.0"},"peerDependencies":{"@sinclair/typebox":"*","@mariozechner/pi-ai":"*","@mariozechner/pi-tui":"*","@mariozechner/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-autoresearch_1.4.0_1778076443125_0.01882404633299606","host":"s3://npm-registry-packages-npm-production"}},"1.5.0":{"name":"pi-autoresearch","version":"1.5.0","keywords":["pi-package","pi","pi-extension","autoresearch","experiment","optimization","benchmark","coding-agent"],"author":{"name":"David Cortés","email":"477473+davebcn87@users.noreply.github.com"},"license":"MIT","_id":"pi-autoresearch@1.5.0","maintainers":[{"name":"davebcn87","email":"david.cortes.18@gmail.com"}],"homepage":"https://github.com/davebcn87/pi-autoresearch#readme","bugs":{"url":"https://github.com/davebcn87/pi-autoresearch/issues"},"pi":{"skills":["./skills"],"extensions":["./extensions"]},"dist":{"shasum":"9d36ff58dad3023e8492e751b09a1ace383f1246","tarball":"https://registry.npmjs.org/pi-autoresearch/-/pi-autoresearch-1.5.0.tgz","fileCount":25,"integrity":"sha512-jYtxc47Nn8i9La4w0Khtquk/JP19na5Ri8lY1oPKB9HTP+zkaXOvOMK5KuspEoceqZxxPJEzCJlMdZrO0lhzdw==","signatures":[{"sig":"MEYCIQDfHd0l4t79OB1/rWSGqt5ZdXt346eWZZkvZ1IQR7uCiwIhAODSrz06fzlYo59TKyzTomJp1Pd3mYDF1h5lYeKhoA3C","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/pi-autoresearch@1.5.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":260381},"type":"module","engines":{"node":">=22"},"gitHead":"b6416b3c8a51e75edd34aa65d0a9a092d5598b76","scripts":{"test":"node --experimental-strip-types --test tests/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:33872b57-bf64-4fe6-8dfb-14665dcb5756"}},"repository":{"url":"git+https://github.com/davebcn87/pi-autoresearch.git","type":"git"},"_npmVersion":"11.16.0","description":"Autonomous experiment loop for pi — run, measure, keep or discard. Inspired by karpathy/autoresearch.","directories":{},"_nodeVersion":"22.22.2","_hasShrinkwrap":false,"packageManager":"pnpm@10.28.2","devDependencies":{"@sinclair/typebox":"^0.34.41","@mariozechner/pi-ai":"^0.65.0","@mariozechner/pi-tui":"^0.65.0","@mariozechner/pi-coding-agent":"^0.65.0"},"peerDependencies":{"@sinclair/typebox":"*","@mariozechner/pi-ai":"*","@mariozechner/pi-tui":"*","@mariozechner/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-autoresearch_1.5.0_1780569518440_0.21486032332331972","host":"s3://npm-registry-packages-npm-production"}},"1.6.0":{"name":"pi-autoresearch","version":"1.6.0","keywords":["pi-package","pi","pi-extension","autoresearch","experiment","optimization","benchmark","coding-agent"],"author":{"name":"David Cortés","email":"477473+davebcn87@users.noreply.github.com"},"license":"MIT","_id":"pi-autoresearch@1.6.0","maintainers":[{"name":"davebcn87","email":"david.cortes.18@gmail.com"}],"homepage":"https://github.com/davebcn87/pi-autoresearch#readme","bugs":{"url":"https://github.com/davebcn87/pi-autoresearch/issues"},"pi":{"skills":["./skills"],"extensions":["./extensions"]},"dist":{"shasum":"0e6087027681ffec8feb7c512da338bc85ff9108","tarball":"https://registry.npmjs.org/pi-autoresearch/-/pi-autoresearch-1.6.0.tgz","fileCount":26,"integrity":"sha512-zbz/udoHALgG/JZ6mDnKV5AiHINOywMDOMgkf4GqyNPwDD1Nl0qehw8JbOTPzYJVi5jb9lVH5qA0E+K81fJLDA==","signatures":[{"sig":"MEQCIG6bT054BvORZVOOW5j0JcX3yhZiSNCRdpGbOsSvy9hdAiB1G6/CnZ30VOsYnmzVGkRTddUrrkvpNzEFwtvWQLYW0g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/pi-autoresearch@1.6.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":261742},"type":"module","engines":{"node":">=22"},"gitHead":"ccba1bae5694678b5f5ef937d18524bc5b71ff25","scripts":{"test":"node --experimental-strip-types --test tests/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:33872b57-bf64-4fe6-8dfb-14665dcb5756"}},"repository":{"url":"git+https://github.com/davebcn87/pi-autoresearch.git","type":"git"},"_npmVersion":"11.16.0","description":"Autonomous experiment loop for pi — run, measure, keep or discard. Inspired by karpathy/autoresearch.","directories":{},"_nodeVersion":"22.22.2","_hasShrinkwrap":false,"packageManager":"pnpm@10.28.2","devDependencies":{"@sinclair/typebox":"^0.34.41","@earendil-works/pi-ai":"^0.74.0","@earendil-works/pi-tui":"^0.74.0","@earendil-works/pi-coding-agent":"^0.74.0"},"peerDependencies":{"@sinclair/typebox":"*","@earendil-works/pi-ai":"*","@earendil-works/pi-tui":"*","@earendil-works/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-autoresearch_1.6.0_1780932172076_0.29004855488050785","host":"s3://npm-registry-packages-npm-production"}},"1.6.1":{"name":"pi-autoresearch","version":"1.6.1","keywords":["pi-package","pi","pi-extension","autoresearch","experiment","optimization","benchmark","coding-agent"],"author":{"name":"David Cortés","email":"477473+davebcn87@users.noreply.github.com"},"license":"MIT","_id":"pi-autoresearch@1.6.1","maintainers":[{"name":"davebcn87","email":"david.cortes.18@gmail.com"}],"homepage":"https://github.com/davebcn87/pi-autoresearch#readme","bugs":{"url":"https://github.com/davebcn87/pi-autoresearch/issues"},"pi":{"skills":["./skills"],"extensions":["./extensions"]},"dist":{"shasum":"a7ae789638af64c9ef10b7f105ab5239ca3c0a86","tarball":"https://registry.npmjs.org/pi-autoresearch/-/pi-autoresearch-1.6.1.tgz","fileCount":26,"integrity":"sha512-/IcncM95b0zDO7pjQNNJRbH/hLtxTRshjJzx318NyKl6nIDML66UZeaDqIwXHGFxnjdSznkT2rJrOhkx0ClC5g==","signatures":[{"sig":"MEUCIQC0KmB17quNIwOziLgWvfUDx05BOZFifyJb0WwVbOUyIwIgd3lW4bq9jjY6lEx9rx58urdBkwk5DKEGYiw6FUSag2g=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/pi-autoresearch@1.6.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":265134},"type":"module","engines":{"node":">=22"},"gitHead":"6e1132c8ad83fbd6e3d6c123e0c62a13e7664dcc","scripts":{"test":"node --experimental-strip-types --test tests/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:33872b57-bf64-4fe6-8dfb-14665dcb5756"}},"repository":{"url":"git+https://github.com/davebcn87/pi-autoresearch.git","type":"git"},"_npmVersion":"11.18.0","description":"Autonomous experiment loop for pi — run, measure, keep or discard. Inspired by karpathy/autoresearch.","directories":{},"_nodeVersion":"22.22.2","_hasShrinkwrap":false,"packageManager":"pnpm@10.28.2","devDependencies":{"@sinclair/typebox":"^0.34.41","@earendil-works/pi-ai":"^0.74.0","@earendil-works/pi-tui":"^0.74.0","@earendil-works/pi-coding-agent":"^0.74.0"},"peerDependencies":{"@sinclair/typebox":"*","@earendil-works/pi-ai":"*","@earendil-works/pi-tui":"*","@earendil-works/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-autoresearch_1.6.1_1782978561543_0.1623065664848815","host":"s3://npm-registry-packages-npm-production"}},"1.6.2":{"name":"pi-autoresearch","version":"1.6.2","keywords":["pi-package","pi","pi-extension","autoresearch","experiment","optimization","benchmark","coding-agent"],"author":{"name":"David Cortés","email":"477473+davebcn87@users.noreply.github.com"},"license":"MIT","_id":"pi-autoresearch@1.6.2","maintainers":[{"name":"davebcn87","email":"david.cortes.18@gmail.com"}],"homepage":"https://github.com/davebcn87/pi-autoresearch#readme","bugs":{"url":"https://github.com/davebcn87/pi-autoresearch/issues"},"pi":{"skills":["./skills"],"extensions":["./extensions"]},"dist":{"shasum":"9276a3b13d2700a4e76abfc8e6d28bd6b7100070","tarball":"https://registry.npmjs.org/pi-autoresearch/-/pi-autoresearch-1.6.2.tgz","fileCount":26,"integrity":"sha512-IjFVFAnSxrMe4wsvkJnvzPcrGKV9xMuhBiE/uH9GSJTpXompPEt8MPHfAj8NBXYB3eYHO5RB5+iYXlUzHnGTDw==","signatures":[{"sig":"MEUCICAVWhs6lIu0/R8rB3j8dn5gIaSBUgoweJu602FGxStYAiEAliTn5s9vrYMkebR1YRTzUkre/KbtbJpWRqBZejJqnK4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/pi-autoresearch@1.6.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":266524},"type":"module","engines":{"node":">=22"},"gitHead":"9c8cc2a8306c8abcf832d20d6ac06a66b1efcc2d","scripts":{"test":"node --experimental-strip-types --test tests/*.test.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:33872b57-bf64-4fe6-8dfb-14665dcb5756"}},"repository":{"url":"git+https://github.com/davebcn87/pi-autoresearch.git","type":"git"},"_npmVersion":"11.18.0","description":"Autonomous experiment loop for pi — run, measure, keep or discard. Inspired by karpathy/autoresearch.","directories":{},"_nodeVersion":"22.22.2","_hasShrinkwrap":false,"packageManager":"pnpm@10.28.2","devDependencies":{"@sinclair/typebox":"^0.34.41","@earendil-works/pi-ai":"^0.74.0","@earendil-works/pi-tui":"^0.74.0","@earendil-works/pi-coding-agent":"^0.74.0"},"peerDependencies":{"@sinclair/typebox":"*","@earendil-works/pi-ai":"*","@earendil-works/pi-tui":"*","@earendil-works/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-autoresearch_1.6.2_1783578846886_0.428633444447456","host":"s3://npm-registry-packages-npm-production"}},"1.7.0":{"name":"pi-autoresearch","version":"1.7.0","type":"module","description":"Autonomous experiment loop for pi — run, measure, keep or discard. Inspired by karpathy/autoresearch.","keywords":["pi-package","pi","pi-extension","autoresearch","experiment","optimization","benchmark","coding-agent"],"license":"MIT","author":{"name":"David Cortés","email":"477473+davebcn87@users.noreply.github.com"},"homepage":"https://github.com/davebcn87/pi-autoresearch#readme","repository":{"type":"git","url":"git+https://github.com/davebcn87/pi-autoresearch.git"},"bugs":{"url":"https://github.com/davebcn87/pi-autoresearch/issues"},"engines":{"node":">=22"},"packageManager":"pnpm@10.28.2","pi":{"extensions":["./extensions"],"skills":["./skills"]},"scripts":{"test":"node --experimental-strip-types --test tests/*.test.mjs"},"peerDependencies":{"@earendil-works/pi-ai":"*","@earendil-works/pi-coding-agent":"*","@earendil-works/pi-tui":"*","@sinclair/typebox":"*"},"devDependencies":{"@earendil-works/pi-ai":"^0.74.0","@earendil-works/pi-coding-agent":"^0.74.0","@earendil-works/pi-tui":"^0.74.0","@sinclair/typebox":"^0.34.41"},"gitHead":"dab7046feedfcc47b406eef36e59a3f4a0d9e508","_id":"pi-autoresearch@1.7.0","_nodeVersion":"22.22.2","_npmVersion":"11.19.1","dist":{"integrity":"sha512-4AnO/MP0maNKELfqBpThINQ0vDvdhdbM4Ph3mg+6Rkfiw+N9OGwBHqcw/jCOy2sdP5dZ+MwAcIl7XReMLBKp7g==","shasum":"33db949897db6b402b4f7c675b19bf802621383a","tarball":"https://registry.npmjs.org/pi-autoresearch/-/pi-autoresearch-1.7.0.tgz","fileCount":26,"unpackedSize":272355,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/pi-autoresearch@1.7.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIA1MlmpD50KTXAKCtE/8m26Sai1XBLnHhr1H6hUk/2ElAiAeGkuyE+9bcU/0vH9pyXRM2DTLKnaUTSv4Foq9xOgNJA=="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:33872b57-bf64-4fe6-8dfb-14665dcb5756"}},"directories":{},"maintainers":[{"name":"davebcn87","email":"david.cortes.18@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/pi-autoresearch_1.7.0_1788184115680_0.5374151042136555"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-28T09:26:32.826Z","modified":"2026-08-31T13:48:36.327Z","1.1.0":"2026-04-28T09:26:33.148Z","1.1.1":"2026-04-28T09:45:50.999Z","1.2.0":"2026-04-28T14:13:23.293Z","1.3.0":"2026-04-29T10:44:39.908Z","1.4.0":"2026-05-06T14:07:23.302Z","1.5.0":"2026-06-04T10:38:38.597Z","1.6.0":"2026-06-08T15:22:52.297Z","1.6.1":"2026-07-02T07:49:21.680Z","1.6.2":"2026-07-09T06:34:07.028Z","1.7.0":"2026-08-31T13:48:35.886Z"},"bugs":{"url":"https://github.com/davebcn87/pi-autoresearch/issues"},"author":{"name":"David Cortés","email":"477473+davebcn87@users.noreply.github.com"},"license":"MIT","homepage":"https://github.com/davebcn87/pi-autoresearch#readme","keywords":["pi-package","pi","pi-extension","autoresearch","experiment","optimization","benchmark","coding-agent"],"repository":{"type":"git","url":"git+https://github.com/davebcn87/pi-autoresearch.git"},"description":"Autonomous experiment loop for pi — run, measure, keep or discard. Inspired by karpathy/autoresearch.","maintainers":[{"name":"davebcn87","email":"david.cortes.18@gmail.com"}],"readme":"<div align=\"center\">\n<img  height=\"120\" alt=\"result\" src=\"https://github.com/user-attachments/assets/c66cbd02-4491-4833-a63a-142cfd7530c1\" />\n\n# pi-autoresearch\n### Autonomous experiment loop for pi\n**[Install](#install)** · **[Usage](#usage)** · **[How it works](#how-it-works)**\n\n</div>\n\n*Try an idea, measure it, keep what works, discard what doesn't, repeat forever.*\n\nAn extension for **[pi](https://pi.dev/)** — an AI coding agent that runs in your terminal. pi-autoresearch gives pi the tools and workflow to run autonomous optimization loops: try an idea, benchmark it, keep improvements, revert regressions, repeat.\n\nInspired by [karpathy/autoresearch](https://github.com/karpathy/autoresearch). Works for any optimization target: test speed, bundle size, LLM training, build times, Lighthouse scores.\n\n---\n\n<img width=\"1736\" height=\"518\" alt=\"pi-autoresearch\" src=\"https://github.com/user-attachments/assets/5078aa31-3530-406a-85fc-bdeff98679a6\" />\n\n---\n\n## Quick start\n\n```bash\npi install npm:pi-autoresearch\n```\n\n## What's included\n\n| | |\n|---|---|\n| **Extension** | Tools + live widget + `/autoresearch` dashboard |\n| **Skill** | Gathers what to optimize, writes session files, starts the loop |\n\n### Extension tools\n\n| Tool | Description |\n|------|-------------|\n| `init_experiment` | One-time session config — name, metric, unit, direction |\n| `run_experiment` | Runs any command, times wall-clock duration, captures output |\n| `log_experiment` | Records result, auto-commits, updates widget and dashboard |\n\n### `/autoresearch` command\n\n| Subcommand | Description |\n|------------|-------------|\n| `/autoresearch <text>` | Enter autoresearch mode. If `.auto/prompt.md` exists, resumes the loop with `<text>` as context. Otherwise, sets up a new session. |\n| `/autoresearch off` | Leave autoresearch mode. Stops auto-resume and clears runtime state but keeps `.auto/log.jsonl` intact. |\n| `/autoresearch clear` | Delete `.auto/log.jsonl`, reset all state, and turn autoresearch mode off. Use this for a clean start. |\n| `/autoresearch export` | Open a live dashboard in your browser. Auto-updates as experiments run. |\n| `/autoresearch dashboard` | Open the fullscreen scrollable dashboard overlay in the terminal. Navigate with `↑`/`↓`/`j`/`k`, `PageUp`/`PageDown`/`u`/`d`, `g`/`G` for top/bottom, `Escape` or `q` to close. |\n\n**Examples:**\n\n```\n/autoresearch optimize unit test runtime, monitor correctness\n/autoresearch model training, run 5 minutes of train.py and note the loss ratio as optimization target\n/autoresearch export\n/autoresearch dashboard\n/autoresearch off\n/autoresearch clear\n```\n\n### Keyboard shortcuts (opt-in)\n\nNo shortcuts are bound by default — pi's built-in keymap grows with every release,\nso any default chord eventually collides with it (this happened with `ctrl+shift+f`\nvs. pi's transcript search). Every action is available as a `/autoresearch`\nsubcommand instead.\n\nTo opt in, add chords to `<agent-dir>/extensions/pi-autoresearch.json`\n(`<agent-dir>` is usually `~/.pi/agent`, or `PI_CODING_AGENT_DIR` when set).\nOmitted or `null` keys stay unbound:\n\n```json\n{\n  \"shortcuts\": {\n    \"fullscreenDashboard\": \"ctrl+shift+y\",\n    \"export\": \"alt+shift+e\",\n    \"off\": null\n  }\n}\n```\n\nEach key binds its `/autoresearch` subcommand: `fullscreenDashboard` → `dashboard`,\n`export` → `export`, `off` → `off`.\n\nPick a chord that's free in [pi's built-in keybindings](https://github.com/badlogic/pi-mono/blob/main/docs/keybindings.md)\nand your `<agent-dir>/keybindings.json` — extension shortcuts win conflicts, so a\nclashing chord hijacks the built-in action.\n\n#### Picking a free chord (guidance for agents)\n\nDon't guess a chord — check it against the installed pi's built-in keymap first:\n\n```bash\nPI_ROOT=$(ls -d ~/.pi/pkg/pi-* 2>/dev/null | sort -V | tail -1)\n[ -n \"$PI_ROOT\" ] || PI_ROOT=\"$(npm root -g)/@earendil-works/pi-coding-agent\"\nnode --input-type=module -e '\nconst { KEYBINDINGS } = await import(process.argv[1] + \"/dist/core/keybindings.js\");\nconst taken = new Set(Object.values(KEYBINDINGS).flatMap(({ defaultKeys }) => defaultKeys).map((key) => key.toLowerCase()));\nconsole.log(taken.has(process.argv[2].toLowerCase()) ? \"TAKEN\" : \"FREE\");\n' \"$PI_ROOT\" ctrl+shift+y\n```\n\nChords in `<agent-dir>/keybindings.json` values are also taken. Write a\nverified-free chord into `<agent-dir>/extensions/pi-autoresearch.json`, then\n`/reload` pi and confirm no `Extension shortcut conflict` warning appears.\n\n`ctrl+shift+y`, `ctrl+shift+u`, `alt+shift+f`, and `ctrl+alt+d` are free as of\npi 0.84.x. Always re-verify — pi's keymap grows over time, which is why this\nextension binds nothing by default.\n\n### UI\n\n- **Dashboard widget** — always visible above the editor: a full results table with columns for commit, metric, status, and description.\n- **Confidence score** — after 3+ runs, shows how the best improvement compares to the session noise floor. ≥2.0× (green) = likely real, 1.0–2.0× (yellow) = above noise but marginal, <1.0× (red) = within noise.\n- **Fullscreen overlay** — `/autoresearch dashboard` opens a scrollable full-terminal dashboard. Shows a live spinner with elapsed time for running experiments.\n\n### Skills\n\n**`autoresearch-create`** asks a few questions (or infers from context) about your goal, command, metric, and files in scope — then writes two files and starts the loop immediately:\n\n**`autoresearch-finalize`** turns a noisy autoresearch branch into clean, independent branches — one per logical change, each starting from the merge-base. Groups must not share files, so each branch can be reviewed and merged independently.\n\n**`autoresearch-hooks`** *(optional)* helps author `.auto/hooks/before.sh` and `.auto/hooks/after.sh` for a session. It ships with ten reference scripts in [`skills/autoresearch-hooks/examples/`](skills/autoresearch-hooks/examples/) (external search, learnings journal, native notifications, anti-thrash, idea rotation, and more) — the skill handles the contract, you pick the inspiration. The core autoresearch loop has no hook awareness.\n\nAll session files live in a single `.auto/` subfolder at the working-directory root — one folder to preserve across reverts, gitignore, and clean up. (Legacy flat `autoresearch.*` files are still read for in-flight sessions.)\n\n| File | Purpose |\n|------|---------|\n| `.auto/prompt.md` | Session document — objective, metrics, files in scope, what's been tried. A fresh agent can resume from this alone. |\n| `.auto/measure.sh` | Benchmark script — pre-checks, runs the workload, outputs `METRIC name=number` lines. |\n| `.auto/log.jsonl` | Append-only log of every run (written by the tools). |\n| `.auto/checks.sh` | *(optional)* Backpressure checks — tests, types, lint. Runs after each passing benchmark. Failures block `keep`. |\n| `.auto/hooks/` | *(optional)* Executable scripts (`before.sh`, `after.sh`) that fire around iterations. Stdout is delivered to the agent as a steer message. |\n\n---\n\n## Install\n\n```bash\npi install npm:pi-autoresearch\n```\n\n<details>\n<summary>Manual install</summary>\n\n```bash\ncp -r extensions/pi-autoresearch ~/.pi/agent/extensions/\ncp -r skills/autoresearch-create ~/.pi/agent/skills/\n```\n\nThen `/reload` in pi.\n\n</details>\n\n---\n\n## Usage\n\n### 1. Start autoresearch\n\n```\n/skill:autoresearch-create\n```\n\nThe agent asks about your goal, command, metric, and files in scope — or infers them from context. It then creates a branch, writes `.auto/prompt.md` and `.auto/measure.sh`, runs the baseline, and starts looping immediately.\n\n### 2. The loop\n\nThe agent runs autonomously: edit → commit → `run_experiment` → `log_experiment` → keep or revert → repeat. It never stops unless interrupted.\n\nEvery result is appended to `.auto/log.jsonl` in your project — one line per run. This means:\n\n- **Survives restarts** — the agent can resume a session by reading the file\n- **Survives context resets** — `.auto/prompt.md` captures what's been tried so a fresh agent has full context\n- **Human readable** — open it anytime to see the full history\n- **Branch-aware** — each branch has its own session\n\n### 3. Finalize into reviewable branches\n\n```\n/skill:autoresearch-finalize\n```\n\nThe agent reads `.auto/log.jsonl`, groups kept experiments into logical changesets, proposes the grouping for your approval, then creates independent branches from the merge-base. Each commit includes metric improvements in the message. Groups must not share files, so branches can be reviewed and merged independently.\n\n### 4. Monitor progress\n\n- **Widget** — full results table, always visible above the editor\n- **`/autoresearch dashboard`** — fullscreen scrollable dashboard overlay (optional chord: `shortcuts.fullscreenDashboard`)\n- **`/autoresearch export`** — open a live browser dashboard with chart and share card\n- **`Escape`** — interrupt anytime and ask for a summary\n\n---\n\n## Example domains\n\n| Domain | Metric | Command |\n|--------|--------|---------|\n| Test speed | seconds ↓ | `pnpm test` |\n| Bundle size | KB ↓ | `pnpm build && du -sb dist` |\n| LLM training | val_bpb ↓ | `uv run train.py` |\n| Build speed | seconds ↓ | `pnpm build` |\n| Lighthouse | perf score ↑ | `lighthouse http://localhost:3000 --output=json` |\n\n---\n\n## How it works\n\nThe **extension** is domain-agnostic infrastructure. The **skill** encodes domain knowledge. This separation means one extension serves unlimited domains.\n\n```\n┌──────────────────────┐     ┌──────────────────────────┐\n│  Extension (global)  │     │  Skill (per-domain)       │\n│                      │     │                           │\n│  run_experiment      │◄────│  command: pnpm test       │\n│  log_experiment      │     │  metric: seconds (lower)  │\n│  widget + dashboard  │     │  scope: vitest configs    │\n│                      │     │  ideas: pool, parallel…   │\n└──────────────────────┘     └──────────────────────────┘\n```\n\nTwo files keep the session alive across restarts and context resets:\n\n```\n.auto/log.jsonl   — append-only log of every run (metric, status, commit, description)\n.auto/prompt.md   — living document: objective, what's been tried, dead ends, key wins\n```\n\nA fresh agent with no memory can read these two files and continue exactly where the previous session left off.\n\n---\n\n## Configuration (optional)\n\nCreate `.auto/config.json` in your pi session directory to customize behavior:\n\n```json\n{\n  \"workingDir\": \"/path/to/project\",\n  \"maxIterations\": 50\n}\n```\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `workingDir` | string | Override the directory for all autoresearch operations — file I/O, command execution, and git. Supports absolute or relative paths (resolved against the pi session cwd). The config file itself always stays under the session cwd. Fails if the directory doesn't exist. |\n| `maxIterations` | number | Maximum experiments before auto-stopping. The agent is told to stop and won't run more experiments until a new segment is initialized. |\n\n### Long-running loops and context\n\nThe loop is designed to run unattended across context limits. When pi's [auto-compaction](https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/compaction.md) summarizes the older portion of the conversation, autoresearch detects the resulting idle and re-prompts the agent to re-read `.auto/prompt.md`, the tail of `.auto/log.jsonl`, `.auto/ideas.md`, and `git log` before continuing. All progress is persisted in those files, so the post-summary turn rehydrates from the source of truth instead of relying on whatever survived compaction. No tuning required — if pi's auto-compaction is enabled (the default), this just works.\n\n---\n\n## Confidence scoring\n\nAfter 3+ experiments in a session, pi-autoresearch computes a **confidence score** — how the best improvement compares to the session's noise floor. This helps distinguish real gains from benchmark jitter, especially on noisy signals like ML training, Lighthouse scores, or flaky benchmarks.\n\n**How it works:**\n\n- Uses [Median Absolute Deviation (MAD)](https://en.wikipedia.org/wiki/Median_absolute_deviation) of all metric values in the current segment as a robust noise estimator.\n- Confidence = `|best_improvement| / MAD`. A score of 2.0× means the best improvement is twice the noise floor.\n- Shown in the widget, fullscreen dashboard, and `log_experiment` output.\n- Persisted to `.auto/log.jsonl` on each result for post-hoc analysis.\n- **Advisory only** — never auto-discards. The agent is guided to re-run experiments when confidence is low, but the final keep/discard decision stays with the agent.\n\n| Confidence | Color | Meaning |\n|-----------|-------|---------|\n| ≥ 2.0× | 🟢 green | Improvement is likely real |\n| 1.0–2.0× | 🟡 yellow | Above noise but marginal |\n| < 1.0× | 🔴 red | Within noise — consider re-running to confirm |\n\n---\n\n## Backpressure checks (optional)\n\nCreate `.auto/checks.sh` to run correctness checks (tests, types, lint) after every passing benchmark. This ensures optimizations don't break things.\n\n```bash\n#!/bin/bash\nset -euo pipefail\npnpm test --run\npnpm typecheck\n```\n\n**How it works:**\n\n- If the file doesn't exist, everything behaves exactly as before — no changes to the loop.\n- If it exists, it runs automatically after every benchmark that exits 0.\n- Checks execution time does **not** affect the primary metric.\n- If checks fail, the experiment is logged as `checks_failed` (same behavior as a crash — no commit, revert changes).\n- The `checks_failed` status is shown separately in the dashboard so you can distinguish correctness failures from benchmark crashes.\n- Checks have a separate timeout (default 300s, configurable via `checks_timeout_seconds` in `run_experiment`).\n\n---\n\n## Hooks (optional)\n\nDrop executable scripts in `.auto/hooks/` to run code at iteration boundaries. Hooks are **transparent to the agent** — the agent calls tools and sees results; hooks run alongside without any agent-facing surface.\n\n- `.auto/hooks/before.sh` — fires before every iteration (at `/autoresearch` activation and at the end of every `log_experiment`, after `after.sh`). Use for prospective work: fetch research, prime context for the next attempt.\n- `.auto/hooks/after.sh` — fires at the end of every `log_experiment`. Use for retrospective work: annotate learnings, send notifications.\n\n**Contract:**\n\n- Must be executable (`chmod +x`). Preserved on revert — the entire `.auto/` folder survives (as do legacy `autoresearch.*` artefacts).\n- **Stdin** — a JSON object on a single line. Shape depends on the stage (see below). Extract fields with `jq`.\n- **Stdout** is delivered to the agent as a steer message (capped at 8 KB). Empty stdout = silent.\n- Non-zero exit or >30s timeout surfaces an error steer to the agent.\n- Each fire appends a `{\"type\":\"hook\",…}` entry to `.auto/log.jsonl` for observability.\n\n**`before.sh` stdin** (on fresh activation `last_run` is `null`):\n\n```json\n{\n  \"event\": \"before\",\n  \"cwd\": \"/path/to/workdir\",\n  \"next_run\": 6,\n  \"last_run\": {\n    \"run\": 5, \"status\": \"discard\", \"metric\": 42.1,\n    \"description\": \"…\",\n    \"asi\": { \"hypothesis\": \"…\", \"next_focus\": \"…\" }\n  },\n  \"session\": {\n    \"metric_name\": \"total_ms\", \"metric_unit\": \"ms\", \"direction\": \"lower\",\n    \"baseline_metric\": 40.7, \"best_metric\": 33.5,\n    \"run_count\": 5, \"goal\": \"optimize sort speed\"\n  }\n}\n```\n\n**`after.sh` stdin:**\n\n```json\n{\n  \"event\": \"after\",\n  \"cwd\": \"/path/to/workdir\",\n  \"run_entry\": {\n    \"run\": 6, \"status\": \"discard\", \"metric\": 38.9,\n    \"description\": \"…\",\n    \"asi\": { \"hypothesis\": \"…\", \"learned\": \"…\" }\n  },\n  \"session\": { \"metric_name\": \"total_ms\", \"direction\": \"lower\", \"baseline_metric\": 40.7, \"best_metric\": 33.5, \"run_count\": 6, \"goal\": \"…\" }\n}\n```\n\n**Agent signal.** The agent writes `description` and `asi.*` fields in its `log_experiment` calls for its own future-self reasoning. The hook opportunistically mines whichever fields the agent naturally uses — `asi.hypothesis`, `asi.next_focus`, `description`, etc. There is no dedicated \"hook input\" field; the agent is unaware the hook exists.\n\n**Examples.** Reference scripts for both stages live at [`skills/autoresearch-hooks/examples/`](skills/autoresearch-hooks/examples/) — external search, qmd document search, persistent learnings, native notifications, git tagging, anti-thrash, idea rotator, hypothesis reflection, context rotation. Copy one to your session's `.auto/hooks/` directory, adapt, `chmod +x`.\n\n---\n\n## Prerequisites\n\n1. **Install pi** — follow the instructions at [pi.dev](https://pi.dev/)\n2. **An API key** for your preferred LLM provider (configured in pi)\n\n## Controlling costs\n\nAutoresearch loops run autonomously and can burn through tokens. Two ways to cap spend:\n\n- **API key limits** — most providers let you set per-key or monthly budgets. Check your provider's dashboard.\n- **`maxIterations`** — cap experiments per session in `.auto/config.json`:\n   ```json\n   {\n     \"maxIterations\": 30\n   }\n   ```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}