Create oclif commands with inversify
Last updated a year ago by mrabe .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install inversify-oclif-utils 
SYNC missed versions from official npm registry.


Create oclif commands with InversifyJS.

oclif Version Downloads/week License CircleCI codecov

Getting Started

These instructions will get you up and running.


Make sure you have InversifyJS and Oclif installed.

It's best to start with a fresh Oclif installation and add InversifyJS to it. Ofcourse you could install Oclif in an existing project manually (but you have to figure this out on your own).


Install this plugin with npm:

npm install inversify-oclif-utils --save

Or with Yarn:

yarn add inversify-oclif-utils

Afterwards add it to your package.json:

  "oclif": {
    "plugins": {

Creating Commands

Now we will get you started with creating commands.

... injecting Services

If you want to inject other services into your commands, you must setup the container like this:

import { useContainer } from 'inversify-oclif-utils'
import { Container } from 'inversify'

const container = new Container();

You do this before running any Oclif commands. For example, at the top of your Oclif "binary" in the /bin folder.

Afterwards you can inject other services in your commands like this:

import { Command } from 'inversify-oclif-utils'
import { inject } from 'inversify'

export class YourCommand extends Command {

  protected foo!: FooService

  async run () {
    return true

Please note, that you have to use my implementation of the Command class for it to work.

... loading Commands dynamically

If you want to dynamically load your commands into Oclif without putting them in a specified command directory (the default way in Oclif). You can use our @command() decorator.

import { command } from 'inversify-oclif-utils'
import { Command } from '@oclif/command'

export class YourCommand extends Command {

The command can then be run by:

./bin/YOURBIN your:command

Make sure you put commands that are loaded with the decorator not into the Oclif command directory. Otherwise it might be loaded twice.

... or both

You can do both things at once.

import { Command, command } from 'inversify-oclif-utils'
import { inject } from 'inversify'

export class YourCommand extends Command {

  protected foo!: FooService

  async run () {
    return true


Please read for details on our code of conduct, and the process for submitting pull requests to us.


We use SemVer for versioning. For the versions available, see the tags on this repository.


This project is licensed under the MIT License - see the file for details


Current Tags

  • 0.1.1                                ...           latest (a year ago)

2 Versions

  • 0.1.1                                ...           a year ago
  • 0.1.0                                ...           a year ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (5)
Dev Dependencies (14)
Dependents (0)

Copyright 2014 - 2017 © |