asp-cli 0.5.0

Command line client for Agentic SOC Platform

ASP CLI

Command line client for Agentic SOC Platform.

asp-cli provides the asp command for SOC analysts and automation agents to authenticate with an ASP server, inspect cases and alerts, add comments, upload files, run playbooks, and query investigation integrations.

Install

pipx install asp-cli

Quick start

asp auth login --api-url https://asp.example.com --api-key asp_xxx
asp doctor
asp case list

asp auth login verifies the API URL and API key against the ASP server before writing local settings.

For automation and skills, prefer stable JSON output:

asp case list --output json

Publish to PyPI

The GitHub release workflow publishes asp-cli to PyPI automatically when a v<version> tag is pushed. The CLI package version does not include the leading v and must match the main release version, so update version in pyproject.toml before creating the tag.

For example, release tag v0.1.0 publishes PyPI version 0.1.0.

Automatic publishing

The workflow uses PyPI Trusted Publishing, so it does not need a PyPI API token in the repository or GitHub Secrets. Configure PyPI once with a trusted publisher:

• PyPI project: asp-cli
• Owner/repository: FunnyWolf/agentic-soc-platform
• Workflow: release.yml
• Environment: pypi

If the PyPI project does not exist yet, add the same entry under PyPI's pending publishers before the first release.

Release steps:

# Update cli\pyproject.toml first, for example: version = "0.1.0"
git tag v0.1.0
git push origin v0.1.0

Manual fallback

Manual publishing requires a PyPI API token. Keep it local and do not commit it:

cd cli
Remove-Item -Recurse -Force dist -ErrorAction SilentlyContinue
uv build
uvx twine check dist\*
$env:UV_PUBLISH_TOKEN = "pypi-..."
uv publish --token $env:UV_PUBLISH_TOKEN

After publishing, verify the package can be installed:

pipx install --force asp-cli
asp --version