{"_id":"@andrewgolovanov/god","_rev":"7-d2d746740a0eb63c0368e4bd34bbd3cf","name":"@andrewgolovanov/god","dist-tags":{"latest":"0.1.6"},"versions":{"0.1.0":{"name":"@andrewgolovanov/god","version":"0.1.0","keywords":["agent","agents","automation","cli","planning","skills"],"license":"UNLICENSED","_id":"@andrewgolovanov/god@0.1.0","maintainers":[{"name":"andrewgolovanov","email":"spacewebdeveloper@gmail.com"}],"homepage":"https://github.com/andrewgolovanov/god#readme","bugs":{"url":"https://github.com/andrewgolovanov/god/issues"},"bin":{"god":"dist/adapters/cli/main.js"},"dist":{"shasum":"e1c8c6f3332b1a3ff735a0f6c6d44943fbf9f092","tarball":"https://registry.npmjs.org/@andrewgolovanov/god/-/god-0.1.0.tgz","fileCount":109,"integrity":"sha512-BFSsGJzi54NcmkKYemjTSB8CQOCRrVIFIk6G263VzC9g3cbXAYM435OBZl+O8FnEy+Tzk3rXrmHUFgC8swCMgA==","signatures":[{"sig":"MEUCICUOqGQAPAn/be74Ri1Kl9Gl3LQ5cVP/qEkewBbIbagdAiEAhXC3IpVl53kIGx3i6ywuW37cak0M9Si1/yW0Bpj4vjU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":142718},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"1f773eb09a3c70e233755fa906d7e1f9240dc01e","scripts":{"dev":"tsx src/adapters/cli/main.ts","test":"vitest run","build":"tsc -p tsconfig.json","prepack":"npm run build","pack:dry":"npm pack --dry-run","pack:local":"npm pack","test:smoke":"vitest run tests/integration/cli-smoke.test.ts","test:watch":"vitest","prepublishOnly":"npm run build && npm run test && npm run test:smoke"},"_npmUser":{"name":"andrewgolovanov","email":"spacewebdeveloper@gmail.com"},"repository":{"url":"git+https://github.com/andrewgolovanov/god.git","type":"git"},"_npmVersion":"10.9.4","description":"CLI-first personal agent runtime for reusable skills and planning workflows.","directories":{},"_nodeVersion":"22.21.1","dependencies":{"zod":"^4.1.12","openai":"^6.45.0","commander":"^14.0.1","@clack/prompts":"^1.6.0","@anthropic-ai/sdk":"^0.107.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.6","vitest":"^4.0.15","typescript":"^5.9.3","@types/node":"^24.10.2"},"_npmOperationalInternal":{"tmp":"tmp/god_0.1.0_1782910808423_0.7064027259227899","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@andrewgolovanov/god","version":"0.1.1","keywords":["agent","agents","automation","cli","planning","skills"],"license":"UNLICENSED","_id":"@andrewgolovanov/god@0.1.1","maintainers":[{"name":"andrewgolovanov","email":"spacewebdeveloper@gmail.com"}],"homepage":"https://github.com/andrewgolovanov/god#readme","bugs":{"url":"https://github.com/andrewgolovanov/god/issues"},"bin":{"god":"dist/adapters/cli/main.js"},"dist":{"shasum":"1f8f6d102e23308fa86827e78be0345bc6890d0d","tarball":"https://registry.npmjs.org/@andrewgolovanov/god/-/god-0.1.1.tgz","fileCount":109,"integrity":"sha512-Ty6zqsA0cBVxbBh+bQ4M+OkRgyfUXQc/Dc+Gp88ugm2AmbIfW4iDx8EUVIXKzplRuefiLgMYa502CKWqSjsw9Q==","signatures":[{"sig":"MEUCIQDC0aTxI2Me2TBOWtlSoAubdWyRcKS9+GZ7N75c1tU3KQIgflMNxcufbNA3NBK19Do9jS3CviNOtt4OtISkIszfDEk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":151325},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"06e4d7f687e6100ecd6af2dbcee063827118bbc8","scripts":{"dev":"tsx src/adapters/cli/main.ts","test":"vitest run","build":"tsc -p tsconfig.json","prepack":"npm run build","pack:dry":"npm pack --dry-run","pack:local":"npm pack","test:smoke":"vitest run tests/integration/cli-smoke.test.ts","test:watch":"vitest","prepublishOnly":"npm run build && npm run test && npm run test:smoke"},"_npmUser":{"name":"andrewgolovanov","email":"spacewebdeveloper@gmail.com"},"repository":{"url":"git+https://github.com/andrewgolovanov/god.git","type":"git"},"_npmVersion":"10.9.4","description":"CLI-first personal agent runtime for reusable skills and planning workflows.","directories":{},"_nodeVersion":"22.21.1","dependencies":{"zod":"^4.1.12","openai":"^6.45.0","commander":"^14.0.1","@clack/prompts":"^1.6.0","@anthropic-ai/sdk":"^0.107.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.6","vitest":"^4.0.15","typescript":"^5.9.3","@types/node":"^24.10.2"},"_npmOperationalInternal":{"tmp":"tmp/god_0.1.1_1782912761661_0.2356037468390697","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@andrewgolovanov/god","version":"0.1.2","keywords":["agent","agents","automation","cli","planning","skills"],"license":"UNLICENSED","_id":"@andrewgolovanov/god@0.1.2","maintainers":[{"name":"andrewgolovanov","email":"spacewebdeveloper@gmail.com"}],"homepage":"https://github.com/andrewgolovanov/god#readme","bugs":{"url":"https://github.com/andrewgolovanov/god/issues"},"bin":{"god":"dist/adapters/cli/main.js"},"dist":{"shasum":"e590b339f48f5c8ca570cc2dad6a5fd6d6fb3103","tarball":"https://registry.npmjs.org/@andrewgolovanov/god/-/god-0.1.2.tgz","fileCount":111,"integrity":"sha512-CuiRqxPz73clojUlj0S/8/4LvfI1c8pvemjuf3KfYX1AQQYRlBPTcPMmHoEJOlcTonplC8plRPgiznjKxlD7PQ==","signatures":[{"sig":"MEYCIQCbIrOssik/tM3mPQ2HMHObUrvSReHZ5kUTrZBJJRoJtgIhAIY48gt7r+gkLXfPLS8rsPLRiVaZEz7u9dwGwsQVQQ3t","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":165844},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"06e4d7f687e6100ecd6af2dbcee063827118bbc8","scripts":{"dev":"tsx src/adapters/cli/main.ts","test":"vitest run","build":"tsc -p tsconfig.json","prepack":"npm run build","pack:dry":"npm pack --dry-run","pack:local":"npm pack","test:smoke":"vitest run tests/integration/cli-smoke.test.ts","test:watch":"vitest","prepublishOnly":"npm run build && npm run test && npm run test:smoke"},"_npmUser":{"name":"andrewgolovanov","email":"spacewebdeveloper@gmail.com"},"repository":{"url":"git+https://github.com/andrewgolovanov/god.git","type":"git"},"_npmVersion":"10.9.4","description":"CLI-first personal agent runtime for reusable skills and planning workflows.","directories":{},"_nodeVersion":"22.21.1","dependencies":{"zod":"^4.1.12","openai":"^6.45.0","commander":"^14.0.1","@clack/prompts":"^1.6.0","@anthropic-ai/sdk":"^0.107.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.6","vitest":"^4.0.15","typescript":"^5.9.3","@types/node":"^24.10.2"},"_npmOperationalInternal":{"tmp":"tmp/god_0.1.2_1782914163335_0.1808072220209933","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@andrewgolovanov/god","version":"0.1.3","keywords":["agent","agents","automation","cli","planning","skills"],"license":"UNLICENSED","_id":"@andrewgolovanov/god@0.1.3","maintainers":[{"name":"andrewgolovanov","email":"spacewebdeveloper@gmail.com"}],"homepage":"https://github.com/andrewgolovanov/god#readme","bugs":{"url":"https://github.com/andrewgolovanov/god/issues"},"bin":{"god":"dist/adapters/cli/main.js"},"dist":{"shasum":"0c6667517d1803748e268d12d0ba55ead45ebe71","tarball":"https://registry.npmjs.org/@andrewgolovanov/god/-/god-0.1.3.tgz","fileCount":111,"integrity":"sha512-N9fud++fC/+/OS0BKpg3DtM0VFbnHYl/ZNeIsPJklHNaRbfLVvZxRs35nvu8zXDEW56A9TG6RGpo6/pFDwvEWw==","signatures":[{"sig":"MEYCIQD88j8XJVWd/m5lySgxFjyZT0aUD04LM2+onriJ2+G5WgIhAOrfizR6q6+V2INGEtd7JYD5zrmj95a7I0nb4f2+lafl","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":172862},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"06e4d7f687e6100ecd6af2dbcee063827118bbc8","scripts":{"dev":"tsx src/adapters/cli/main.ts","test":"vitest run","build":"tsc -p tsconfig.json","prepack":"npm run build","pack:dry":"npm pack --dry-run","pack:local":"npm pack","test:smoke":"vitest run tests/integration/cli-smoke.test.ts","test:watch":"vitest","prepublishOnly":"npm run build && npm run test && npm run test:smoke"},"_npmUser":{"name":"andrewgolovanov","email":"spacewebdeveloper@gmail.com"},"repository":{"url":"git+https://github.com/andrewgolovanov/god.git","type":"git"},"_npmVersion":"10.9.4","description":"CLI-first personal agent runtime for reusable skills and planning workflows.","directories":{},"_nodeVersion":"22.21.1","dependencies":{"zod":"^4.1.12","openai":"^6.45.0","commander":"^14.0.1","@clack/prompts":"^1.6.0","@anthropic-ai/sdk":"^0.107.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.6","vitest":"^4.0.15","typescript":"^5.9.3","@types/node":"^24.10.2"},"_npmOperationalInternal":{"tmp":"tmp/god_0.1.3_1782916014060_0.16831078098025865","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@andrewgolovanov/god","version":"0.1.4","keywords":["agent","agents","automation","cli","planning","skills"],"license":"UNLICENSED","_id":"@andrewgolovanov/god@0.1.4","maintainers":[{"name":"andrewgolovanov","email":"spacewebdeveloper@gmail.com"}],"homepage":"https://github.com/andrewgolovanov/god#readme","bugs":{"url":"https://github.com/andrewgolovanov/god/issues"},"bin":{"god":"dist/adapters/cli/main.js"},"dist":{"shasum":"c5cbcf0571df518b55bc100d16d42e2a584ca0f6","tarball":"https://registry.npmjs.org/@andrewgolovanov/god/-/god-0.1.4.tgz","fileCount":111,"integrity":"sha512-iPd51HamYoz04OEQ7ctZrp5kO7OclJ8d/MQreyvnjmDyI6gXrzkRpTRmub/n5H5Xh17aE4OLbiOGCuSOrUE4iA==","signatures":[{"sig":"MEUCIQDQcHeW00UBE/yn5hRBUrmH9VF2Jayj8aFH/rBemh9asQIgK/YCX2rb9S/NTK7lC4/MttelG5UsObbZBGBFNlDjH40=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":175523},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"06e4d7f687e6100ecd6af2dbcee063827118bbc8","scripts":{"dev":"tsx src/adapters/cli/main.ts","test":"vitest run","build":"tsc -p tsconfig.json","prepack":"npm run build","pack:dry":"npm pack --dry-run","pack:local":"npm pack","test:smoke":"vitest run tests/integration/cli-smoke.test.ts","test:watch":"vitest","prepublishOnly":"npm run build && npm run test && npm run test:smoke"},"_npmUser":{"name":"andrewgolovanov","email":"spacewebdeveloper@gmail.com"},"repository":{"url":"git+https://github.com/andrewgolovanov/god.git","type":"git"},"_npmVersion":"10.9.4","description":"CLI-first personal agent runtime for reusable skills and planning workflows.","directories":{},"_nodeVersion":"22.21.1","dependencies":{"zod":"^4.1.12","openai":"^6.45.0","commander":"^14.0.1","@clack/prompts":"^1.6.0","@anthropic-ai/sdk":"^0.107.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.6","vitest":"^4.0.15","typescript":"^5.9.3","@types/node":"^24.10.2"},"_npmOperationalInternal":{"tmp":"tmp/god_0.1.4_1782918888569_0.09350450264567156","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@andrewgolovanov/god","version":"0.1.5","keywords":["agent","agents","automation","cli","planning","skills"],"license":"UNLICENSED","_id":"@andrewgolovanov/god@0.1.5","maintainers":[{"name":"andrewgolovanov","email":"spacewebdeveloper@gmail.com"}],"homepage":"https://github.com/andrewgolovanov/god#readme","bugs":{"url":"https://github.com/andrewgolovanov/god/issues"},"bin":{"god":"dist/adapters/cli/main.js"},"dist":{"shasum":"f5d76c7cb3d590a365af05063a597dafc5fa577e","tarball":"https://registry.npmjs.org/@andrewgolovanov/god/-/god-0.1.5.tgz","fileCount":111,"integrity":"sha512-971UL2jW+IcywewJcxnvouc/jBtvz7hu5TxvwEI1sQhw8zv00mZYsrwM5kH7uolm5XM8SM6qXA750YusCGWDTQ==","signatures":[{"sig":"MEUCIAVdjC2pKVla1VDbpVvojdIstdZM+7zIjLAnsUCzT7AdAiEA8ojeqLaQoRCabp9dYeZXwmHBwGrpvyFl2LvHSGHLgzo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":175551},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"06e4d7f687e6100ecd6af2dbcee063827118bbc8","scripts":{"dev":"tsx src/adapters/cli/main.ts","test":"vitest run","build":"tsc -p tsconfig.json","prepack":"npm run build","pack:dry":"npm pack --dry-run","pack:local":"npm pack","test:smoke":"vitest run tests/integration/cli-smoke.test.ts","test:watch":"vitest","prepublishOnly":"npm run build && npm run test && npm run test:smoke"},"_npmUser":{"name":"andrewgolovanov","email":"spacewebdeveloper@gmail.com"},"repository":{"url":"git+https://github.com/andrewgolovanov/god.git","type":"git"},"_npmVersion":"10.9.4","description":"CLI-first personal agent runtime for reusable skills and planning workflows.","directories":{},"_nodeVersion":"22.21.1","dependencies":{"zod":"^4.1.12","openai":"^6.45.0","commander":"^14.0.1","@clack/prompts":"^1.6.0","@anthropic-ai/sdk":"^0.107.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.6","vitest":"^4.0.15","typescript":"^5.9.3","@types/node":"^24.10.2"},"_npmOperationalInternal":{"tmp":"tmp/god_0.1.5_1782919956022_0.7766270506063553","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@andrewgolovanov/god","version":"0.1.6","type":"module","description":"CLI-first personal agent runtime for reusable skills and planning workflows.","license":"UNLICENSED","repository":{"type":"git","url":"git+https://github.com/andrewgolovanov/god.git"},"bugs":{"url":"https://github.com/andrewgolovanov/god/issues"},"homepage":"https://github.com/andrewgolovanov/god#readme","keywords":["agent","agents","automation","cli","planning","skills"],"main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"bin":{"god":"dist/adapters/cli/main.js"},"publishConfig":{"access":"public"},"scripts":{"build":"tsc -p tsconfig.json","dev":"tsx src/adapters/cli/main.ts","pack:dry":"npm pack --dry-run","pack:local":"npm pack","prepack":"npm run build","prepublishOnly":"npm run build && npm run test && npm run test:smoke","test":"vitest run","test:smoke":"vitest run tests/integration/cli-smoke.test.ts","test:watch":"vitest"},"dependencies":{"@anthropic-ai/sdk":"^0.107.0","@clack/prompts":"^1.6.0","commander":"^14.0.1","openai":"^6.45.0","zod":"^4.1.12"},"devDependencies":{"@types/node":"^24.10.2","tsx":"^4.20.6","typescript":"^5.9.3","vitest":"^4.0.15"},"engines":{"node":">=22"},"_id":"@andrewgolovanov/god@0.1.6","gitHead":"06e4d7f687e6100ecd6af2dbcee063827118bbc8","_nodeVersion":"22.21.1","_npmVersion":"10.9.4","dist":{"integrity":"sha512-RSkSqtH7y9HRVP3I4bmbhWtezCrFHPlMG8HwfjoWTpYhHg3AhX1//SPDhVULo2dd1SPxCneSJgDFiPotp6GsDw==","shasum":"798eda79daefe2bcc7dcde4b326dea8ce36d8ae4","tarball":"https://registry.npmjs.org/@andrewgolovanov/god/-/god-0.1.6.tgz","fileCount":111,"unpackedSize":176368,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDCKqzI288SiZyprZ9Q7g5BE+eEZM8FcaPD0Qfe5ou4ngIhAO4NIh6i/14gb6VfQ6u6judtaCPHZf7ZajvRuvTzOPId"}]},"_npmUser":{"name":"andrewgolovanov","email":"spacewebdeveloper@gmail.com"},"directories":{},"maintainers":[{"name":"andrewgolovanov","email":"spacewebdeveloper@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/god_0.1.6_1782925438081_0.5257605955257758"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-01T13:00:08.255Z","modified":"2026-07-01T17:03:58.323Z","0.1.0":"2026-07-01T13:00:08.606Z","0.1.1":"2026-07-01T13:32:41.818Z","0.1.2":"2026-07-01T13:56:03.471Z","0.1.3":"2026-07-01T14:26:54.247Z","0.1.4":"2026-07-01T15:14:48.699Z","0.1.5":"2026-07-01T15:32:36.218Z","0.1.6":"2026-07-01T17:03:58.213Z"},"bugs":{"url":"https://github.com/andrewgolovanov/god/issues"},"license":"UNLICENSED","homepage":"https://github.com/andrewgolovanov/god#readme","keywords":["agent","agents","automation","cli","planning","skills"],"repository":{"type":"git","url":"git+https://github.com/andrewgolovanov/god.git"},"description":"CLI-first personal agent runtime for reusable skills and planning workflows.","maintainers":[{"name":"andrewgolovanov","email":"spacewebdeveloper@gmail.com"}],"readme":"# god\n\nCLI-first personal agent runtime for reusable skills, project context collection,\nand plan-first workflows.\n\nThe current MVP is intentionally plan-only: it classifies a task, loads runtime\nskills, collects bounded target-project context, creates a structured plan,\npersists run artifacts, and waits for explicit approval. It does not edit target\nproject files.\n\n> Last reviewed: 2026-07-01\n\n## Current Status\n\nThis repository is the package root for the MVP. The npm package name is\n`@andrewgolovanov/god`, and the installed CLI command is `god`. Mutable runtime\nstate lives in `~/.godmode` by default, so the CLI can be run from any directory\nafter install, build, or linking. Pass target projects with `--project`.\n\nFuture goals include an installer, Telegram/Web/Codex/MCP adapters, parallel\ntask execution, implementation workflows, checks, commits, and PRs. Those are\nnot part of the current MVP.\n\n## Requirements\n\n- Node.js 22+\n- pnpm 11+\n- Optional remote provider key, saved by `god setup` or provided through env:\n  - `OPENAI_API_KEY`\n  - `ANTHROPIC_API_KEY`\n\n## Setup\n\nInstall from npm after the package is published:\n\n```bash\nnpm install -g @andrewgolovanov/god\ngod doctor\ngod setup\n```\n\nThe GitHub repo may remain private while the npm package is public. Anything\nincluded in the npm tarball is public after `npm publish`, so package contents\nare restricted with the `files` allowlist in `package.json`.\n\nLocal development setup:\n\n```bash\npnpm install\nnpm run build\nnode dist/adapters/cli/main.js setup\n```\n\nOptional local global command:\n\n```bash\npnpm link --global\ngod doctor\n```\n\nFor local/offline planning:\n\n```bash\nnode dist/adapters/cli/main.js setup --provider heuristic\n```\n\nFor OpenAI:\n\n```bash\nnode dist/adapters/cli/main.js setup --provider openai --model gpt-5.5 --reasoning xhigh\n```\n\nInteractive `god setup` also offers OpenAI model profiles and reasoning effort\nchoices. Use `xhigh` for the \"Extra high\" reasoning level. If `OPENAI_API_KEY`\nis not available, setup can save it locally in `<god-home>/secrets.env`.\n\nFor Anthropic Claude:\n\n```bash\nnode dist/adapters/cli/main.js setup --provider anthropic\n```\n\nManage saved provider keys:\n\n```bash\ngod secrets list\ngod secrets set openai\ngod secrets remove openai\n```\n\n## Quick Use\n\nPlan work for an existing project:\n\n```bash\ncd /path/to/target-project\ngod plan \"task context\"\ngod plan --project /path/to/other-project \"task context\"\n```\n\nWhen `--project` is omitted, `god plan` uses the current working directory as\nthe target project.\n\nPlan a new project:\n\n```bash\ngod new \"build a small personal notes CLI\"\n```\n\nApprove a run:\n\n```bash\ngod approve <run-id>\n```\n\nList runs and skills:\n\n```bash\ngod runs\ngod skills list\ngod config\ngod doctor\n```\n\nFind and import skills:\n\n```bash\ngod skills find react performance\ngod skills add vercel-labs/agent-skills@vercel-react-best-practices\ngod skills add https://github.com/obra/superpowers --skill brainstorming\ngod skills import /path/to/local/skill\ngod skills remove <skill-id>\n```\n\nDuring development, the same commands can be run through `tsx`:\n\n```bash\npnpm run dev -- plan --project fixtures/projects/minimal-node --context fixtures/tasks/simple-feature.md\npnpm run dev -- plan \"task context from the current project\"\n```\n\nUse a custom runtime home when testing isolated state:\n\n```bash\nnode dist/adapters/cli/main.js --god-home /tmp/god-home doctor\nGOD_HOME=/tmp/god-home node dist/adapters/cli/main.js doctor\n```\n\n## Key Docs\n\n- [CLI usage](docs/god-cli.md)\n- [Runtime layout](docs/runtime-layout.md)\n- [Implementation plan](docs/superpowers/plans/2026-07-01-personal-agent-runtime-implementation-plan.md)\n- [Architecture design](docs/superpowers/specs/2026-06-30-personal-agent-runtime-design.md)\n\n## Development\n\n```bash\nnpm run build\nnpm run test\nnpm run test:smoke\nnpm run pack:dry\n```\n\nThe smoke test exercises `setup`, `plan`, `approve`, and `new` against fixture\nprojects without calling real AI provider APIs.\n\nVerify the npm tarball locally before publishing:\n\n```bash\nnpm run pack:local\nnpm install --global --prefix /private/tmp/god-install ./andrewgolovanov-god-0.1.6.tgz\n/private/tmp/god-install/bin/god --god-home /private/tmp/god-install-home doctor\n```\n\n## Runtime Guarantees\n\n- Target project files are not modified by the MVP.\n- Run artifacts are stored under `<god-home>/runs/<run-id>/`.\n- Local AI settings are stored in `<god-home>/config.json`.\n- Saved provider API keys are stored in `<god-home>/secrets.env`, not in\n  `config.json`.\n- User-imported `SKILL.md` skills are stored under\n  `<god-home>/skills/imported/`.\n- Project-local `AGENTS.md`, `.codex/AGENTS.md`, `.cursor/rules/*.mdc`,\n  `.agents/skills`, and `.codex/skills` are read during `god plan` without\n  being copied into `<god-home>`.\n- Default runtime home is `~/.godmode`.\n- Shell environment API keys override saved provider keys.\n- Domain and application layers stay independent of CLI, filesystem, and SDK\n  details.\n\n## Known Limits\n\n- The npm package is prepared for public scoped publishing, but `npm publish`\n  remains a manual release step.\n- Current workflows stop at planning and approval.\n- Skill update/check/lock workflows are future slices.\n- Checks, implementation, commits, PRs, Telegram, Web/PWA, Codex plugin, MCP,\n  SQLite, and background jobs are future slices.\n- Ollama/local model support is deferred until the cloud-provider contract is\n  stable.\n","readmeFilename":"README.md"}