tsoft-cli

Command-line tool for tsoft360 theme development and management.

Installation

npm install -g tsoft-cli

Requirements

• Node.js >= 18.0.0

Quick Start

# Sign in
tsoft login

# List available themes
tsoft theme list

# Pull an existing theme
tsoft theme pull

# Start dev mode (hot-reload)
tsoft theme dev

Commands

Authentication

| Command | Description | |----------------|-----------------------------------------| | tsoft login | Sign in via OAuth2 | | tsoft logout | Sign out and clear stored tokens | | tsoft whoami | Show the signed-in user and active shop |

Theme Management

| Command | Description | | ---------------------------- | ----------------------------------------- | | tsoft theme list | List all themes | | tsoft theme create | Create a new theme (interactive) | | tsoft theme pull | Pull an existing theme | | tsoft theme use [name] | Set the active theme | | tsoft theme dev [name] | Start dev mode (hot-reload) | | tsoft theme publish [name] | Publish the theme to the TSoftApps market | | tsoft theme section list | List blocks and sections | | tsoft theme section add | Add a section (interactive) |

Publishing a Theme

# Using the active theme
tsoft theme publish

# Using a specific theme
tsoft theme publish my-theme

On the first publish you enter the initial version number. Subsequent updates prompt for a semantic-versioning bump type (patch / minor / major).

Security

• OAuth2 PKCE: Secure authorization as a public client
• State parameter: CSRF protection
• Secure storage: Tokens are readable only by the owner (chmod 600)
• Auto-refresh: Access tokens are refreshed automatically when they expire

Troubleshooting

# Check the current session
tsoft whoami

# Re-authenticate from scratch
tsoft logout
tsoft login

License

MIT