Create or delete system user accounts in OS X, Linux and Windows.
Last updated 4 years ago by mh-cbon .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @mh-cbon/roster 
SYNC missed versions from official npm registry.


Create or delete system user accounts in Mac, Linux and Windows.


npm install @mh-cbon/roster --save


var roster = require('@mh-cbon/roster');

roster.exists('username', function(exists) {
  console.log('User exists? ' + exists);

roster.create({ user: 'new_guy', full_name: 'The New Guy' }, function(err) {
  if (!err) console.log('Successfully created.')

roster.delete('bad_user', function(err) {
  if (!err) console.log('Successfully deleted.')

roster.get_groups('bad_user', function(err, groups) {
  err && console.error(err);
  groups && console.log(JSON.stringify(groups, null, 2))

As a binary

npm install @mh-cbon/roster -g


@mh-cbon/roster 0.0.3

Usage: roster [command] [user] [opts]


 roster exists [user] [opts]

 roster groups [user] [opts]

 roster create [user] [opts]
   --home|-h       Create the home directory
   --home_dir|-d   Specify the home directory path
   --full_name|-f  Set the user full name
   --user_id|-i    Set the user ID
   --group_id|-g   Set the group ID
   --shell|-s      Set the user shell
   --groups        List of additionals comma separated groups to subscribe
   --system        Linux only, create a system account (-r)
   --hidden        Macos only, create an hidden account
   --guest         Macos only, create a guest account

 roster delete [user] [opts]
   --remove|-r     Delete the home directory


   --json          Print results as JSON


  • install vagrant from the official website
  • add vbguest plugin vagrant plugin install vbguest
  • add wrmi plugin vagrant plugin install wrmi
  • sh mocha.sh


Written by Tomás Pollak. MIT licensed.

Current Tags

  • 0.0.6                                ...           latest (4 years ago)

3 Versions

  • 0.0.6                                ...           4 years ago
  • 0.0.5                                ...           4 years ago
  • 0.0.4                                ...           4 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 1
Dependencies (10)
Dev Dependencies (1)
Dependents (0)

Copyright 2014 - 2016 © taobao.org |