llms.txt

Bosca CLI

A command-line tool for managing content, workflows, infrastructure, scripting, localization, CI/CD, and AI tool integration — with GraalVM native binary support.

Overview

The Bosca CLI (bosca) is built with Clikt and Apollo Kotlin. It communicates with the server via GraphQL and provides commands for every major subsystem. It compiles to a GraalVM native binary for fast startup.

Authentication

The CLI supports three authentication flows:

bash

Credentials are stored in ~/.config/bosca/config.json (owner-read/write only). Tokens are automatically refreshed on each command invocation.

Every command also accepts --url, --token, or --username/--password overrides, plus environment variables BOSCA_ENDPOINT, BOSCA_TOKEN, BOSCA_USERNAME, BOSCA_PASSWORD.

Command Tree

Content Management (data)

bash

Work Operations (workops)

Full issue tracking with portfolios, programs, projects, tasks, sprints, and boards:

bash

BX Projects (bx)

Compile and serve BX document projects:

bash

Localization (localization)

bash

CI/CD (ci)

bash

API Tokens (tokens)

bash

Kubernetes (kubernetes)

Generate and apply Kubernetes manifests using cdk8s:

bash

MCP Server

The CLI includes a Model Context Protocol (MCP) server for AI tool integration. It exposes structured tools for content management, task tracking, and more:

bash

MCP tools include: content_metadata (CRUD + set content), content_collection (CRUD + items), content_supplementary, content_relationship, content_template, and full WorkOps task management.