devsync profile
List available profiles and switch the active profile.
Synopsis
Section titled “Synopsis”devsync profile listdevsync profile use [profile]Description
Section titled “Description”Profiles let you organize tracked entries by machine or context. When a profile is active, push, pull, and status only operate on entries that either belong to that profile or have no profile assigned (global entries).
Profile names are free-form strings (e.g. work, personal, home-mac). They are stored in manifest.json alongside the entries that reference them. The active profile is persisted in ~/.config/devsync/settings.json.
profile list
Section titled “profile list”Lists all profile names referenced across all entries in manifest.json. Highlights the profile currently set as active.
Options
Section titled “Options”| Flag | Description |
|---|---|
--verbose | Print detailed output. |
Example
Section titled “Example”devsync profile listAvailable profiles: work personal* home-mac ← activeprofile use
Section titled “profile use”Sets the active profile in ~/.config/devsync/settings.json. Subsequent push, pull, and status invocations will use this profile unless overridden with --profile.
Omit the profile name argument to clear the active profile. When no profile is active, only global entries (those with no profile assigned) are included in sync operations.
Arguments
Section titled “Arguments”| Argument | Description |
|---|---|
profile | Optional. The name of the profile to activate. Omit to clear the active profile. |
Options
Section titled “Options”| Flag | Description |
|---|---|
--verbose | Print detailed output. |
Examples
Section titled “Examples”# Activate the "work" profiledevsync profile use work# Clear the active profile — only global entries will syncdevsync profile useProfiles and the --profile flag
Section titled “Profiles and the --profile flag”The --profile flag on push, pull, and status provides a one-time override without changing the active profile in settings.json.
# Temporarily check status for the "personal" profiledevsync status --profile personal
# The active profile is unchanged after this commanddevsync profile list # still shows the previous active profile