Atomemo Plugin CLI

A command-line utility for building and publishing Choiceform Atomemo plugins.

Features

• 🔐 Authentication: Device authorization flow for secure login
• 🚀 Plugin Initialization: Interactive setup for new Atomemo plugins
• 🔑 API Key Management: Refresh debug API keys for development
• 📦 Plugin Management: Create, develop, and manage Atomemo plugins
• 🌍 Multi-language Support: Support for TypeScript, Python, and Elixir (coming soon)

Installation

npm install -g @choiceopen/atomemo-plugin-cli

Or using other package managers:

# Using yarn
yarn global add @choiceopen/atomemo-plugin-cli
# Using pnpm
pnpm add -g @choiceopen/atomemo-plugin-cli

Quick Start

1. Login to your Choiceform account:

   atomemo auth login

2. Create a new plugin:

   atomemo plugin init

3. Get your debug API key:

   atomemo plugin refresh-key

Usage

$ atomemo COMMANDrunning command...
$ atomemo (--version)@choiceopen/atomemo-plugin-cli/0.2.5 darwin-arm64 node-v24.13.0
$ atomemo --help [COMMAND]USAGE $ atomemo COMMAND...

Commands

• atomemo autocomplete [SHELL]
• atomemo help [COMMAND]
• atomemo version

atomemo autocomplete [SHELL]

Display autocomplete installation instructions.

USAGE
$ atomemo autocomplete [SHELL] [-r]
ARGUMENTS
[SHELL] (zsh|bash|powershell) Shell type
FLAGS
-r, --refresh-cache Refresh cache (ignores displaying instructions)
DESCRIPTION
Display autocomplete installation instructions.
EXAMPLES
$ atomemo autocomplete
$ atomemo autocomplete bash
$ atomemo autocomplete zsh
$ atomemo autocomplete powershell
$ atomemo autocomplete --refresh-cache

See code: @oclif/plugin-autocomplete

atomemo help [COMMAND]

Display help for atomemo.

USAGE
$ atomemo 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 atomemo.

See code: @oclif/plugin-help

atomemo version

USAGE
$ atomemo version [--json] [--verbose]
FLAGS
--verbose Show additional information about the CLI.
GLOBAL FLAGS
--json Format output as json.
FLAG DESCRIPTIONS
--verbose Show additional information about the CLI.
Additionally shows the architecture, node version, operating system, and versions of plugins that the CLI is using.

See code: @oclif/plugin-version

Requirements

• Node.js >= 20.0.0
• npm, yarn, or pnpm

Development

# Clone the repository
git clone https://github.com/choice-open/atomemo-plugin-cli.git
cd atomemo-plugin-cli
# Install dependencies
npm install
# Build the project
npm run build
# Run tests
npm test# Run the CLI in development mode
./bin/dev.js <command>

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Documentation

• Architecture Documentation
• Command Documentation
• Changelog

License

MIT © Choiceform

Related Projects

• Choiceform Atomemo Platform

Support

• 📖 Documentation
• 🐛 Issue Tracker
• 💬 Discussions