npm package: @phibar/dotsloth
Description: Sync your dots, be a sloth - Dev environment sync CLI for macOS
Author: phibar
Latest version: 0.0.1

dotsloth
=================

A new CLI generated with oclif


[![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
[![Version](https://img.shields.io/npm/v/dotsloth.svg)](https://npmjs.org/package/dotsloth)
[![Downloads/week](https://img.shields.io/npm/dw/dotsloth.svg)](https://npmjs.org/package/dotsloth)


<!-- toc -->
* [Usage](#usage)
* [Commands](#commands)
<!-- tocstop -->
# Usage
<!-- usage -->
```sh-session
$ 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
...
```
<!-- usagestop -->
# Commands
<!-- commands -->
* [`dotsloth clone URL`](#dotsloth-clone-url)
* [`dotsloth help [COMMAND]`](#dotsloth-help-command)
* [`dotsloth init`](#dotsloth-init)
* [`dotsloth org add [NAME]`](#dotsloth-org-add-name)
* [`dotsloth org list`](#dotsloth-org-list)
* [`dotsloth org remove NAME`](#dotsloth-org-remove-name)
* [`dotsloth org update [NAME]`](#dotsloth-org-update-name)
* [`dotsloth plugins`](#dotsloth-plugins)
* [`dotsloth plugins add PLUGIN`](#dotsloth-plugins-add-plugin)
* [`dotsloth plugins:inspect PLUGIN...`](#dotsloth-pluginsinspect-plugin)
* [`dotsloth plugins install PLUGIN`](#dotsloth-plugins-install-plugin)
* [`dotsloth plugins link PATH`](#dotsloth-plugins-link-path)
* [`dotsloth plugins remove [PLUGIN]`](#dotsloth-plugins-remove-plugin)
* [`dotsloth plugins reset`](#dotsloth-plugins-reset)
* [`dotsloth plugins uninstall [PLUGIN]`](#dotsloth-plugins-uninstall-plugin)
* [`dotsloth plugins unlink [PLUGIN]`](#dotsloth-plugins-unlink-plugin)
* [`dotsloth plugins update`](#dotsloth-plugins-update)
* [`dotsloth secret add NAME`](#dotsloth-secret-add-name)
* [`dotsloth secret export`](#dotsloth-secret-export)
* [`dotsloth secret get NAME`](#dotsloth-secret-get-name)
* [`dotsloth secret list`](#dotsloth-secret-list)
* [`dotsloth secret load`](#dotsloth-secret-load)
* [`dotsloth secret remove NAME`](#dotsloth-secret-remove-name)
* [`dotsloth status`](#dotsloth-status)
* [`dotsloth sync`](#dotsloth-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 git@github.com:ExRam/SomeRepo.git

  $ dotsloth clone https://github.com/ipfs/kubo

  $ dotsloth clone git@github.com:fork/repo.git --org ExRam
```

_See code: [src/commands/clone.ts](https://github.com/phibar/dotsloth/blob/v0.0.1/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](https://github.com/oclif/plugin-help/blob/v6.2.36/src/commands/help.ts)_

## `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 init
```

_See code: [src/commands/init.ts](https://github.com/phibar/dotsloth/blob/v0.0.1/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 philipp@exram.de --username phibar
```

_See code: [src/commands/org/add.ts](https://github.com/phibar/dotsloth/blob/v0.0.1/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 list
```

_See code: [src/commands/org/list.ts](https://github.com/phibar/dotsloth/blob/v0.0.1/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 ExRam
```

_See code: [src/commands/org/remove.ts](https://github.com/phibar/dotsloth/blob/v0.0.1/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 new@email.com
```

_See code: [src/commands/org/update.ts](https://github.com/phibar/dotsloth/blob/v0.0.1/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 plugins
```

_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.54/src/commands/plugins/index.ts)_

## `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/someplugin
```

## `dotsloth 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 myplugin
```

_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.54/src/commands/plugins/inspect.ts)_

## `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/someplugin
```

_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.54/src/commands/plugins/install.ts)_

## `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 myplugin
```

_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.54/src/commands/plugins/link.ts)_

## `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 myplugin
```

## `dotsloth 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](https://github.com/oclif/plugin-plugins/blob/v5.4.54/src/commands/plugins/reset.ts)_

## `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 myplugin
```

_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.54/src/commands/plugins/uninstall.ts)_

## `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 myplugin
```

## `dotsloth 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](https://github.com/oclif/plugin-plugins/blob/v5.4.54/src/commands/plugins/update.ts)_

## `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](https://github.com/phibar/dotsloth/blob/v0.0.1/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 export
```

_See code: [src/commands/secret/export.ts](https://github.com/phibar/dotsloth/blob/v0.0.1/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_ID
```

_See code: [src/commands/secret/get.ts](https://github.com/phibar/dotsloth/blob/v0.0.1/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 list
```

_See code: [src/commands/secret/list.ts](https://github.com/phibar/dotsloth/blob/v0.0.1/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](https://github.com/phibar/dotsloth/blob/v0.0.1/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_ID
```

_See code: [src/commands/secret/remove.ts](https://github.com/phibar/dotsloth/blob/v0.0.1/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 status
```

_See code: [src/commands/status.ts](https://github.com/phibar/dotsloth/blob/v0.0.1/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 sync
```

_See code: [src/commands/sync.ts](https://github.com/phibar/dotsloth/blob/v0.0.1/src/commands/sync.ts)_
<!-- commandsstop -->