{"id":47780,"library":"goose-cli","title":"goose-cli","description":"An unofficial npm wrapper for the goose database migration tool (v3.25.0-a), providing the goose CLI without requiring Go installation. It downloads the appropriate binary for the target OS/architecture on install. Versioning mirrors the upstream goose releases, with frequent updates. Differentiators: no Go toolchain needed, easy integration into Node.js projects, supports major database backends (SQLite, PostgreSQL, MySQL) through goose.","status":"active","version":"3.25.0-a","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","goose","database","migration","cli"],"install":[{"cmd":"npm install goose-cli","lang":"bash","label":"npm"},{"cmd":"yarn add goose-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add goose-cli","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"requires Node.js to download and execute the binary","package":"node","optional":false}],"imports":[{"note":"This is a CLI tool, not a JavaScript library. Use npx or install globally.","wrong":"import goose from 'goose-cli'","symbol":"goose","correct":"npx goose [command]"}],"quickstart":{"code":"npm install --save-dev goose-cli\n# Then in package.json scripts:\n{\n  \"scripts\": {\n    \"db:migrate\": \"goose sqlite3 ./foo.db up\"\n  }\n}\n# Run:\nnpm run db:migrate","lang":"typescript","description":"Installing goose-cli and using it in npm scripts. The goose binary is downloaded at install time."},"warnings":[{"fix":"Refer to goose upstream changelog.","message":"v3.0.0 of goose removed support for some older commands. Check migration from v2 to v3.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Use 'goose create' with proper options.","message":"The 'goose fix' command is deprecated as of goose v3.8.0.","severity":"deprecated","affected_versions":">=3.8.0"},{"fix":"Pre-download the binary manually or set a proxy.","message":"Post-install script may fail in restricted environments where binary download is blocked.","severity":"gotcha","affected_versions":"all"},{"fix":"Ensure npm install is executed on each environment.","message":"The package downloads platform-specific binaries. git clone of a project will not include the binary until npm install is run on the target machine.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'appropri':26 'backend':56 'binari':27 'cli':3,18,66 'databas':11,55,64 'differenti':43 'download':24 'easi':48 'frequent':41 'go':21,45 'goos':2,10,17,38,61,63 'goose-c':1 'instal':22,33 'integr':49 'javascript':62 'major':54 'migrat':12,65 'mirror':35 'mysql':59 'need':47 'node.js':51 'npm':6 'os/architecture':31 'postgresql':58 'project':52 'provid':15 'releas':39 'requir':20 'sqlite':57 'support':53 'target':30 'tool':13 'toolchain':46 'unoffici':5 'updat':42 'upstream':37 'v3.25.0-a':14 'version':34 'without':19 'wrapper':7","created_at":"2026-06-07T16:53:16.498761+00:00","updated_at":"2026-06-07T16:53:16.498761+00:00","problems":[{"fix":"Check internet connection, or manually download binary from https://github.com/pressly/goose/releases and place it in node_modules/.bin/goose.","cause":"Network failure or missing permissions when downloading binary","error":"postinstall script failed"},{"fix":"Run npx goose or add node_modules/.bin to PATH.","cause":"goose-cli not installed or binary not in PATH","error":"goose: command not found"},{"fix":"Use a supported platform or run goose via Docker.","cause":"goose binary not available for your OS/architecture","error":"unsupported platform"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":"goose-cli","openapi_spec":null,"status_page":null,"smithery":null,"categories":["database","devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}