NoimosAI CLI - NoimosAI

Overview

The NoimosAI CLI (@agos-labs/noimosai-cli) lets you interact with your NoimosAI workspace from the command line. Chat with the NoimosAI agent for marketing analysis, content generation, and SEO work, draft and publish both short-form social posts and long-form articles (WordPress, note) across connected platforms, and inspect workspaces and integrations—without leaving your terminal. The CLI is published on npm as @agos-labs/noimosai-cli.

Features

The CLI covers chat, publishing, and workspace management, and is designed to be driven by both humans and AI agents.

Chat — Interactive or one-shot conversations with the NoimosAI agent (marketing analysis, content generation, SEO, and more).
Publish — Push generated content to your connected accounts. Both short-form social posts and long-form articles (WordPress, note) are supported.
Workspace / Integration management — Inspect workspaces and connected integrations from the CLI.
Scriptable — All commands accept flags (no required interactive prompts) and support --output json for machine-readable results.

Common Commands

You can get a feel for what the CLI does before installing. The block below covers the commands most users reach for; full options for each are in the Commands section.

noimosai login                              # Log in (browser OAuth or API key)
noimosai chat                               # Start an interactive chat session
noimosai chat -p "Draft a launch post"      # One-shot prompt
noimosai chat -p "..." -o json              # One-shot prompt, JSON output
noimosai post posts.json --dry-run          # Preview a publish (SNS or article)
noimosai post posts.json --now              # Publish immediately
noimosai workspace list                     # List workspaces you can access
noimosai integration list                   # List connected accounts

Supported Publishing Platforms

Both short-form social posts and long-form articles can be published from a single posts.json file. The platform field in each post entry determines the destination, and the same noimosai post command handles all of them.

Type	Platform
SNS	X (Twitter), Threads, Facebook, Instagram, YouTube, LinkedIn, TikTok, Bluesky, Pinterest
Article	WordPress, note

Requirements

Confirm the following before installing.

Node.js >= 18
An active NoimosAI account (sign up)

Installation

Install globally with your preferred package manager.

pnpm add -g @agos-labs/noimosai-cli

npm install -g @agos-labs/noimosai-cli

After installation, the noimosai command becomes available in your shell.

Quick Start

The fastest path is to log in, then start chatting with the NoimosAI agent.

1. Log in

noimosai login

You can authenticate in one of two ways:

Browser login (OAuth) — Opens your browser to complete authentication.
API key — Paste an API key generated from your team settings on NoimosAI. To create one, open NoimosAI, go to your team settings, and copy a key from the API tab.

For non-interactive environments (CI/CD), pass the key directly:

noimosai login --api-key "$NOIMOS_API_KEY"

2. Start chatting

noimosai chat

This opens an interactive session with the NoimosAI agent. From here you can ask questions, request marketing outputs, or iterate on content.

NoimosAI CLI chat session running in a terminal

3. Discover all commands

noimosai --help

Use --help on any command to see every available option in the version you have installed.

Commands

Run noimosai <command> --help for full options on any command.

Authentication

Use these commands to sign in or remove stored credentials.

Command	Description
`noimosai login`	Interactive login (browser OAuth or API key)
`noimosai login --oauth`	Force browser OAuth
`noimosai login --api-key <key>`	Non-interactive API key login (CI/CD)
`noimosai logout`	Remove stored credentials

Chat

Chat is the most common command and supports both interactive and one-shot use.

Command	Description
`noimosai chat`	Interactive chat session
`noimosai chat -p "<message>"`	One-shot prompt
`noimosai chat -r <session-id>`	Resume a previous session
`noimosai chat -p "<message>" -o json`	JSON output (scripting / piping)
`noimosai chat -w <workspace-id>`	Override default workspace

Publishing

Use noimosai post to publish or schedule posts from a posts.json file.

noimosai post posts.json --dry-run                     # Preview what would be sent
noimosai post posts.json --now                         # Publish immediately
noimosai post posts.json --schedule "2026-04-10 09:00" # Schedule
noimosai post posts.json --now -o json                 # JSON result for scripts

posts.json is normally produced by the chat session (the agent emits it for you). When hand-crafting it, the schema is:

{
  "version": "1",
  "metadata": { "generatedAt": "2026-04-27T09:00:00Z" },
  "posts": [
    {
      "platform": "WordPress",        // display label — see table below
      "dataKey": "wpPostData",        // routing key — REQUIRED, drives publishing
      "providerAccountId": "...",     // required for publishing (not for --dry-run)
      "textBlocks": [{ "text": "..." }],
      "media": []
    }
  ]
}

The dataKey field is what actually routes a post to its destination. Use the value from this table:

Platform (label)	`dataKey`
X (Twitter)	`xPostData`
Threads	`thPostData`
Facebook	`fbPostData`
Instagram	`igPostData`
YouTube	`ytPostData`
LinkedIn	`linkedinPostData`
TikTok	`ttPostData`
Bluesky	`blueskyPostData`
Pinterest	`pinterestPostData`
Note	`notePostData`
WordPress	`wpPostData`

Workspace and Integrations

Use these commands to inspect what is available to the current account.

Command	Description
`noimosai workspace list`	List workspaces you can access
`noimosai integration list`	List connected external integrations

Configuration

Manage local CLI configuration with the following commands.

Command	Description
`noimosai config show`	Show current configuration
`noimosai config get <key>`	Read one config value
`noimosai config set <key> <val>`	Set a config value
`noimosai config path`	Print path of the config file

Global Options

The following flags are available on every command.

-o, --output <text\|json> — Output format (default text). json is intended for scripts and AI agents.
--help — Available on every command and subcommand.

CI / Agent Usage

The CLI is designed to be driven by both humans and AI agents. The patterns below show recommended headless and idempotent flows.

# Headless login
noimosai login --api-key "$NOIMOS_API_KEY" -o json

# One-shot prompt, JSON result
noimosai chat -p "Draft a LinkedIn post about our launch" -o json

# Idempotent dry-run before any destructive publish
noimosai post posts.json --dry-run
noimosai post posts.json --now -o json

Troubleshooting

The following are the most common issues users hit.

Cannot find package 'zod' — your global install is older than 0.0.2. Reinstall with npm i -g @agos-labs/noimosai-cli.
Not authenticated — run noimosai login again.
Workspace ID not configured — re-run noimosai login, or pass -w <workspace-id> per command.

​Overview

​Features

​Common Commands

​Supported Publishing Platforms

​Requirements

​Installation

​Quick Start

​1. Log in

​2. Start chatting

​3. Discover all commands

​Commands

​Authentication

​Chat

​Publishing

​Workspace and Integrations

​Configuration

​Global Options

​CI / Agent Usage

​Troubleshooting

​Related