BlackSails.Cli 0.3.2

Black Sails CLI

Build and deploy ASP.NET Core applications or declarative AI agents from your own machine.

dotnet tool install --global BlackSails.Cli
blacksails login
blacksails init
blacksails deploy

BlackSails can also dispatch builds from its dashboard to Runnable. Repositories use the standard .runnable/workflows/blacksails.yml template; its runnable-build command authenticates with Runnable OIDC and is not intended to be invoked from a developer workstation.

Black Sails supports ASP.NET Core projects targeting .NET 8, 9, or 10 on Linux x64.

Declarative agents

Create, validate, and deploy an agent without shipping executable customer code:

blacksails agent init ./support-agent
blacksails agent validate ./support-agent
blacksails agent deploy ./support-agent --app support-agent

The CLI deterministically packages directories as ZIPs and applies the same path, file type, size, YAML, skill, model, and MCP policy checks as the server. Only agent.yaml, Markdown instructions, and supported text/data skill files are accepted.

GitHub Actions and other CI systems

Set an expiring, scoped service token in BLACKSAILS_TOKEN; the CLI will use it instead of reading the interactive device-login session. A CI job can deploy without writing blacksails.json:

blacksails deploy --application my-api --project src/MyApi/MyApi.csproj

Use the official blacksails/deploy-action for GitHub Actions. It also waits for readiness and reports the production URL and deployment ID as outputs.