Status

Stability

Vishnu is on version 0.1.0. Until 1.0, a minor release can change the public API, so pin the version you test against.

Limits and errors

• Node 24 or newer.
• check, test, build and dev need the pinned kernel in the local cache or a reachable portal. Without either, the command stops and tells you to set VISHNU_PORTAL.
• A kernel file with the wrong size or digest is rejected. Vishnu does not fall back to another kernel.
• vishnu test fails when the project has no *.test.ts files, so an empty project never reports a green run.
• vishnu new refuses a name that is not kebab-case or a directory that already exists.
• defineCartridge and the authoring factories throw CartridgeError, which carries every diagnostic it found. The CLI prints project, kernel and cartridge errors as a plain message without a stack.
• The CLI has no login, upload or publish command. vishnu build stops at a static site.

Contribute and license

MIT. See LICENSE. The CLI bundles Clack and its small dependency closure. Their license notices ship in dist/cli/THIRD_PARTY_LICENSES.txt.