Repository files navigation

Discover and install Atom packages powered byatom.io

You can configure apm by using theapm config command line option (recommended) or by manually editing the~/.atom/.apmrc file as per thenpm config.

apm bundlesnpm with it and spawnsnpm processes to install Atom packages. The major difference is thatapm sets multiple command line arguments tonpm to ensure that native modules are built against Chromium's v8 headers instead of node's v8 headers.

The other major difference is that Atom packages are installed to~/.atom/packages instead of a localnode_modules folder and Atom packages are published to and installed from GitHub repositories instead ofnpmjs.com

Therefore you can think ofapm as a simplenpm wrapper that builds on top of the many strengths ofnpm but is customized and optimized to be used for Atom packages.

apm is bundled and installed automatically with Atom. You can run theAtom > Install Shell Commands menu option to install it again if you aren't able to run it from a terminal (macOS only).

• Clone the repository
• 🐧 Installlibsecret-1-dev (or the relevantlibsecret development dependency) if you are on Linux
• Runnpm install; this will install the dependencies with your built-in version of Node/npm, and then rebuild them with the bundled versions.
• Run./bin/npm run build to compile the CoffeeScript code (or.\bin\npm.cmd run build on Windows)
• Run./bin/npm test to run the specs (or.\bin\npm.cmd test on Windows)

apm includesnpm, and spawns it for various processes. It also comes with a bundled version of Node, and this script ensures that npm uses the right version of Node for things like running the tests. If you're using the same version of Node as is listed inBUNDLED_NODE_VERSION, you can skip using this script.

Runapm help to see all the supported commands andapm help <command> tolearn more about a specific command.

The common commands areapm install <package_name> to install a new package,apm featured to see all the featured packages, andapm publish to publisha package toatom.io.

If you have 2fa enabled on your GitHub account, you'll need to generate apersonal access token and provide that when prompted for your password.

If you are behind a firewall and seeing SSL errors when installing packagesyou can disable strict SSL by running:

apm config set strict-ssl false

If you are using a HTTP(S) proxy you can configureapm to use it by running:

apm config set https-proxy https://9.0.2.1:0

You can runapm config get https-proxy to verify it has been set correctly.

You can also runapm config list to see all the custom config settings.