=================

jolie package manager

Version 3.3.0 - Improved npm compatibility and debug output

• JPM
• Usage
• Commands

$ npm install -g @jolie/jpm
$ jpm COMMAND
running command...
$ jpm (--version)
@jolie/jpm/3.3.1 linux-x64 node-v24.20.0
$ jpm --help [COMMAND]
USAGE
  $ jpm COMMAND
...

• jpm init [PATH]
• jpm install [TARGET]
• jpm remove TARGET

Generate jpm's specific configuration to package.json

USAGE
  $ jpm init [PATH...]

ARGUMENTS
  [PATH...]  Target package

DESCRIPTION
  Generate jpm's specific configuration to package.json

EXAMPLES
  $ jpm init
      add jpm related fields to package.json in current working directory

  $ jpm init [path]
      add jpm related fields to package.json in specify path

See code: src/commands/init.ts

Add Jolie related dependency to the project

USAGE
  $ jpm install [TARGET] [-r mvn|npm]

ARGUMENTS
  [TARGET]  Target package

FLAGS
  -r, --repo=<option>  specify the lookup repository
                       <options: mvn|npm>

DESCRIPTION
  Add Jolie related dependency to the project

EXAMPLES
  $ jpm install
  scan entries from package.json and download all dependencies

  $ jpm install @jolie/websockets
  add @jolie/websockets into the project

  $ jpm install org.jsoup:jsoup
  add maven's jsoup into the project

  $ jpm install jolie-jsoup@latest
  add jolie-jsoup with latest tag into the project

See code: src/commands/install.ts

Remove Jolie related dependency to the project

USAGE
  $ jpm remove TARGET

ARGUMENTS
  TARGET  Target package

DESCRIPTION
  Remove Jolie related dependency to the project
  Currently, it removes the corresponding entry on package.json file and perform install command


EXAMPLES
  $ jpm remove jolie-jsoup
      Remove jolie-jsoup from the dependencies

See code: src/commands/remove.ts

jpm now provides detailed debug logging to help troubleshoot installation issues.

You can enable debug logging in several ways:

1. Using environment variable:

   JPM_DEBUG=true jpm install <package>

2. Using npm loglevel:

   npm --loglevel=verbose install <package>

3. Using DEBUG environment variable:

   DEBUG=jpm,jpm:* jpm install <package>

• jpm - General jpm operations
• jpm:npm - npm package operations
• jpm:mvn - Maven operations
• jpm:package - Package management operations

npm install and its aliases (npm i, npm add) work with jpm packages:

npm add @jolie/websockets

All three are the same command to npm and are treated identically by jpm. Other npm operations on jpm packages are not supported and fail with an error asking you to use jpm instead — for full Jolie support (including Maven dependencies), jpm install is recommended.

jpm includes an .npmrc file that suppresses unnecessary npm warnings by default. The configuration:

• Disables npm audit (reduces warnings)
• Disables fund messages
• Sets loglevel to error by default (reduces noise)

You can override these settings by creating your own .npmrc file or using command-line flags with npm.