0.9.0 • Published 3 months ago
@theneo/cli v0.9.0
Theneo CLI
Install
npm install -g @theneo/cli
Usage
theneo help
Usage: theneo [options] [command]
A CLI for the Theneo application
Options:
-V, --version output the version number
-h, --help display help for command
Commands:
login Login in theneo cli
project <action> Theneo's project related commands
workspace <action> Theneo's workspace related commands
help [command] display help for command
Examples
Login
theneo login
#or
theneo login --token <theneo-api-key>
Create new project
Usage: theneo project create [options]
Create new project
Options:
--name <name> Project name
--workspace <workspace> Enter workspace slug where the project should be created in, if not present uses default workspace
-f, --file <file> API file path to import (eg: docs/openapi.yml)
--link <link> API file URL to create project using it
--postman-api-key <postman-api-key> Postman API Key (env: THENEO_POSTMAN_API_KEY)
--postman-collection <postman-collection-id> Postman collection id
--empty Creates empty project (default: false)
--sample Creates project with sample template (default: false)
--publish Publish the project after creation (default: false)
--public Make published documentation to be publicly accessible. Private by default (default: false)
--generate-description <generate-description> Indicates if AI should be used for description generation (choices: "fill", "overwrite", "no_generation", default: "no_generation")
--profile <string> Use a specific profile from your config file.
-h, --help display help for command
- create new project interactively
theneo project create
Create the project directly using api spec file
theneo project create --name api-documentation --generate-description overwrite --publish --public --file ./examples/openapi-spec.json
Create project using a link to api documentation
theneo project create --name api-documentation --generate-description fill --publish --public --link https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/examples/v3.0/uspto.json
- Create a project from Postman collections
theneo project create --name api-documentation --postman-api-key <key> --postman-collection <id-1> --postman-collection <id-2>
Update api documentation from api spec file
Usage: theneo project import [options]
Update theneo project with a updated API file
Options:
--key <project-key> Specify the project key to import updated documentation in
-f, --file <file> API file path to import (eg: docs/openapi.yml)
--link <link> API file URL to create project using it
--postman-api-key <postman-api-key> Postman API Key (env: THENEO_POSTMAN_API_KEY)
--postman-collection <postman-collection-id> Postman collection id
--import-type <import-type> Indicates how should the new api spec be imported (choices: "overwrite", "merge", "endpoints")
--publish Automatically publish the project (default: false)
--profile <string> Use a specific profile from your config file.
-h, --help display help for command
theneo project import --file <file> --project <project-key> --publish
Publish document
theneo project publish --key <project-key>
Delete project
theneo project delete --key <project-key>