@phibar/dotsloth
v0.0.1
Published
Sync your dots, be a sloth - Dev environment sync CLI for macOS
Maintainers
Readme
dotsloth
A new CLI generated with oclif
Usage
$ npm install -g @phibar/dotsloth
$ dotsloth COMMAND
running command...
$ dotsloth (--version)
@phibar/dotsloth/0.0.1 linux-x64 node-v25.2.1
$ dotsloth --help [COMMAND]
USAGE
$ dotsloth COMMAND
...Commands
dotsloth clone URLdotsloth help [COMMAND]dotsloth initdotsloth org add [NAME]dotsloth org listdotsloth org remove NAMEdotsloth org update [NAME]dotsloth pluginsdotsloth plugins add PLUGINdotsloth plugins:inspect PLUGIN...dotsloth plugins install PLUGINdotsloth plugins link PATHdotsloth plugins remove [PLUGIN]dotsloth plugins resetdotsloth plugins uninstall [PLUGIN]dotsloth plugins unlink [PLUGIN]dotsloth plugins updatedotsloth secret add NAMEdotsloth secret exportdotsloth secret get NAMEdotsloth secret listdotsloth secret loaddotsloth secret remove NAMEdotsloth statusdotsloth sync
dotsloth clone URL
Clone a repository to the correct organization folder
USAGE
$ dotsloth clone URL [-o <value>]
ARGUMENTS
URL Repository URL to clone
FLAGS
-o, --org=<value> Override organization (use a different org than detected)
DESCRIPTION
Clone a repository to the correct organization folder
EXAMPLES
$ dotsloth clone [email protected]:ExRam/SomeRepo.git
$ dotsloth clone https://github.com/ipfs/kubo
$ dotsloth clone [email protected]:fork/repo.git --org ExRamSee code: src/commands/clone.ts
dotsloth help [COMMAND]
Display help for dotsloth.
USAGE
$ dotsloth help [COMMAND...] [-n]
ARGUMENTS
[COMMAND...] Command to show help for.
FLAGS
-n, --nested-commands Include all nested commands in the output.
DESCRIPTION
Display help for dotsloth.See code: @oclif/plugin-help
dotsloth init
Initialize dotsloth on this machine
USAGE
$ dotsloth init [-f] [--skip-secrets] [--skip-ssh]
FLAGS
-f, --force Overwrite existing configuration
--skip-secrets Skip secrets extraction from zprofile
--skip-ssh Skip SSH keychain setup
DESCRIPTION
Initialize dotsloth on this machine
EXAMPLES
$ dotsloth initSee code: src/commands/init.ts
dotsloth org add [NAME]
Add a new organization configuration
USAGE
$ dotsloth org add [NAME] [-e <value>] [-u <value>]
ARGUMENTS
[NAME] Organization name (e.g., ExRam)
FLAGS
-e, --email=<value> Git email for this organization
-u, --username=<value> Git username for this organization
DESCRIPTION
Add a new organization configuration
EXAMPLES
$ dotsloth org add
$ dotsloth org add ExRam --email [email protected] --username phibarSee code: src/commands/org/add.ts
dotsloth org list
List configured organizations
USAGE
$ dotsloth org list [--json]
FLAGS
--json Output as JSON
DESCRIPTION
List configured organizations
EXAMPLES
$ dotsloth org listSee code: src/commands/org/list.ts
dotsloth org remove NAME
Remove an organization configuration
USAGE
$ dotsloth org remove NAME [--delete-repos] [-f]
ARGUMENTS
NAME Organization name to remove
FLAGS
-f, --force Skip confirmation
--delete-repos Also delete the repository folder
DESCRIPTION
Remove an organization configuration
EXAMPLES
$ dotsloth org remove ExRamSee code: src/commands/org/remove.ts
dotsloth org update [NAME]
Update an organization configuration
USAGE
$ dotsloth org update [NAME] [-e <value>] [-u <value>]
ARGUMENTS
[NAME] Organization name to update
FLAGS
-e, --email=<value> New git email
-u, --username=<value> New git username
DESCRIPTION
Update an organization configuration
EXAMPLES
$ dotsloth org update
$ dotsloth org update ExRam
$ dotsloth org update ExRam --email [email protected]See code: src/commands/org/update.ts
dotsloth plugins
List installed plugins.
USAGE
$ dotsloth plugins [--json] [--core]
FLAGS
--core Show core plugins.
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
List installed plugins.
EXAMPLES
$ dotsloth pluginsSee code: @oclif/plugin-plugins
dotsloth plugins add PLUGIN
Installs a plugin into dotsloth.
USAGE
$ dotsloth plugins add PLUGIN... [--json] [-f] [-h] [-s | -v]
ARGUMENTS
PLUGIN... Plugin to install.
FLAGS
-f, --force Force npm to fetch remote resources even if a local copy exists on disk.
-h, --help Show CLI help.
-s, --silent Silences npm output.
-v, --verbose Show verbose npm output.
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Installs a plugin into dotsloth.
Uses npm to install plugins.
Installation of a user-installed plugin will override a core plugin.
Use the DOTSLOTH_NPM_LOG_LEVEL environment variable to set the npm loglevel.
Use the DOTSLOTH_NPM_REGISTRY environment variable to set the npm registry.
ALIASES
$ dotsloth plugins add
EXAMPLES
Install a plugin from npm registry.
$ dotsloth plugins add myplugin
Install a plugin from a github url.
$ dotsloth plugins add https://github.com/someuser/someplugin
Install a plugin from a github slug.
$ dotsloth plugins add someuser/someplugindotsloth plugins:inspect PLUGIN...
Displays installation properties of a plugin.
USAGE
$ dotsloth plugins inspect PLUGIN...
ARGUMENTS
PLUGIN... [default: .] Plugin to inspect.
FLAGS
-h, --help Show CLI help.
-v, --verbose
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Displays installation properties of a plugin.
EXAMPLES
$ dotsloth plugins inspect mypluginSee code: @oclif/plugin-plugins
dotsloth plugins install PLUGIN
Installs a plugin into dotsloth.
USAGE
$ dotsloth plugins install PLUGIN... [--json] [-f] [-h] [-s | -v]
ARGUMENTS
PLUGIN... Plugin to install.
FLAGS
-f, --force Force npm to fetch remote resources even if a local copy exists on disk.
-h, --help Show CLI help.
-s, --silent Silences npm output.
-v, --verbose Show verbose npm output.
GLOBAL FLAGS
--json Format output as json.
DESCRIPTION
Installs a plugin into dotsloth.
Uses npm to install plugins.
Installation of a user-installed plugin will override a core plugin.
Use the DOTSLOTH_NPM_LOG_LEVEL environment variable to set the npm loglevel.
Use the DOTSLOTH_NPM_REGISTRY environment variable to set the npm registry.
ALIASES
$ dotsloth plugins add
EXAMPLES
Install a plugin from npm registry.
$ dotsloth plugins install myplugin
Install a plugin from a github url.
$ dotsloth plugins install https://github.com/someuser/someplugin
Install a plugin from a github slug.
$ dotsloth plugins install someuser/somepluginSee code: @oclif/plugin-plugins
dotsloth plugins link PATH
Links a plugin into the CLI for development.
USAGE
$ dotsloth plugins link PATH [-h] [--install] [-v]
ARGUMENTS
PATH [default: .] path to plugin
FLAGS
-h, --help Show CLI help.
-v, --verbose
--[no-]install Install dependencies after linking the plugin.
DESCRIPTION
Links a plugin into the CLI for development.
Installation of a linked plugin will override a user-installed or core plugin.
e.g. If you have a user-installed or core plugin that has a 'hello' command, installing a linked plugin with a 'hello'
command will override the user-installed or core plugin implementation. This is useful for development work.
EXAMPLES
$ dotsloth plugins link mypluginSee code: @oclif/plugin-plugins
dotsloth plugins remove [PLUGIN]
Removes a plugin from the CLI.
USAGE
$ dotsloth plugins remove [PLUGIN...] [-h] [-v]
ARGUMENTS
[PLUGIN...] plugin to uninstall
FLAGS
-h, --help Show CLI help.
-v, --verbose
DESCRIPTION
Removes a plugin from the CLI.
ALIASES
$ dotsloth plugins unlink
$ dotsloth plugins remove
EXAMPLES
$ dotsloth plugins remove myplugindotsloth plugins reset
Remove all user-installed and linked plugins.
USAGE
$ dotsloth plugins reset [--hard] [--reinstall]
FLAGS
--hard Delete node_modules and package manager related files in addition to uninstalling plugins.
--reinstall Reinstall all plugins after uninstalling.See code: @oclif/plugin-plugins
dotsloth plugins uninstall [PLUGIN]
Removes a plugin from the CLI.
USAGE
$ dotsloth plugins uninstall [PLUGIN...] [-h] [-v]
ARGUMENTS
[PLUGIN...] plugin to uninstall
FLAGS
-h, --help Show CLI help.
-v, --verbose
DESCRIPTION
Removes a plugin from the CLI.
ALIASES
$ dotsloth plugins unlink
$ dotsloth plugins remove
EXAMPLES
$ dotsloth plugins uninstall mypluginSee code: @oclif/plugin-plugins
dotsloth plugins unlink [PLUGIN]
Removes a plugin from the CLI.
USAGE
$ dotsloth plugins unlink [PLUGIN...] [-h] [-v]
ARGUMENTS
[PLUGIN...] plugin to uninstall
FLAGS
-h, --help Show CLI help.
-v, --verbose
DESCRIPTION
Removes a plugin from the CLI.
ALIASES
$ dotsloth plugins unlink
$ dotsloth plugins remove
EXAMPLES
$ dotsloth plugins unlink myplugindotsloth plugins update
Update installed plugins.
USAGE
$ dotsloth plugins update [-h] [-v]
FLAGS
-h, --help Show CLI help.
-v, --verbose
DESCRIPTION
Update installed plugins.See code: @oclif/plugin-plugins
dotsloth secret add NAME
Add or update a secret in macOS Keychain
USAGE
$ dotsloth secret add NAME [-v <value>]
ARGUMENTS
NAME Secret name (e.g., AWS_ACCESS_KEY_ID)
FLAGS
-v, --value=<value> Secret value (not recommended - use prompt instead)
DESCRIPTION
Add or update a secret in macOS Keychain
EXAMPLES
$ dotsloth secret add AWS_ACCESS_KEY_ID
$ dotsloth secret add OPENAI_API_KEY --value sk-...See code: src/commands/secret/add.ts
dotsloth secret export
Export all secrets (for debugging/migration)
USAGE
$ dotsloth secret export [-f shell|json]
FLAGS
-f, --format=<option> [default: shell] Output format
<options: shell|json>
DESCRIPTION
Export all secrets (for debugging/migration)
EXAMPLES
$ dotsloth secret exportSee code: src/commands/secret/export.ts
dotsloth secret get NAME
Get a secret value from Keychain
USAGE
$ dotsloth secret get NAME
ARGUMENTS
NAME Secret name to retrieve
DESCRIPTION
Get a secret value from Keychain
EXAMPLES
$ dotsloth secret get AWS_ACCESS_KEY_IDSee code: src/commands/secret/get.ts
dotsloth secret list
List all secret names stored in Keychain
USAGE
$ dotsloth secret list
DESCRIPTION
List all secret names stored in Keychain
EXAMPLES
$ dotsloth secret listSee code: src/commands/secret/list.ts
dotsloth secret load
Output export statements for all secrets (for use in shell profile)
USAGE
$ dotsloth secret load
DESCRIPTION
Output export statements for all secrets (for use in shell profile)
EXAMPLES
$ dotsloth secret load
eval "$(dotsloth secret load)"See code: src/commands/secret/load.ts
dotsloth secret remove NAME
Remove a secret from Keychain
USAGE
$ dotsloth secret remove NAME [-f]
ARGUMENTS
NAME Secret name to remove
FLAGS
-f, --force Skip confirmation
DESCRIPTION
Remove a secret from Keychain
EXAMPLES
$ dotsloth secret remove AWS_ACCESS_KEY_IDSee code: src/commands/secret/remove.ts
dotsloth status
Show current dotsloth configuration status
USAGE
$ dotsloth status [-v]
FLAGS
-v, --verbose Show detailed status
DESCRIPTION
Show current dotsloth configuration status
EXAMPLES
$ dotsloth statusSee code: src/commands/status.ts
dotsloth sync
Sync configurations from iCloud Drive
USAGE
$ dotsloth sync [--dry-run] [-f]
FLAGS
-f, --force Force overwrite local files
--dry-run Show what would be synced without making changes
DESCRIPTION
Sync configurations from iCloud Drive
EXAMPLES
$ dotsloth syncSee code: src/commands/sync.ts
