Skip to content

docs(akt): add documentation for the akt CLI - #1295

Draft
chalabi2 wants to merge 4 commits into
akash-network:mainfrom
chalabi2:docs/akt-cli
Draft

docs(akt): add documentation for the akt CLI#1295
chalabi2 wants to merge 4 commits into
akash-network:mainfrom
chalabi2:docs/akt-cli

Conversation

@chalabi2

@chalabi2 chalabi2 commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a new documentation section for akt, the unified Akash CLI that replaces akash, provider-services, and the chain-sdk CLI, under Developers → Deployment → akt CLI (src/content/Docs/developers/deployment/akt/).

Nine pages, mirroring the structure and style of the existing CLI docs:

Page Covers
akt CLI (hub) What akt is, section overview, quick links
Installation Homebrew, GitHub release binaries (macOS/Linux), WSL2, build from source, first-run bootstrap, shell completion
Configuration Contexts, networks, keys, auth methods, capability gating, env vars, output formats, action log
Deployments SDL authoring (akt sdl), deploy/update/close workflows, JSONL mode for CI/CD, local store
Console Integration Managed-wallet setup, USD deployments, live lease ops, marketplace, API keys/JWTs
Queries & Transactions Positional filter argument, module coverage, common examples, BME mint/burn
Network Monitor akt monitor dashboards and navigation
MCP Server AI assistant integration, read-only vs write tools
Commands Reference Full command reference in the existing reference format

Also registers the section in the Deployment Methods hub, the root docs index, and the nav label map (akt → "akt CLI", same pattern as cli → "CLI").

The interactive TUI shell is intentionally not documented yet; it will be added when it ships. All repo/release links point at akash-network/akt.

Add a new docs section under developers/deployment for akt, the unified
Akash CLI that replaces akash, provider-services, and the chain-sdk CLI.
Covers installation (Homebrew, binary, source), contexts and
configuration, SDL authoring and deployment workflows, Console
managed-wallet integration, chain queries and transactions, the network
monitor, the MCP server, and a full command reference.

Register the section in the deployment hub, the root docs index, and the
nav label map. The interactive TUI shell is intentionally not documented
until it ships.

Signed-off-by: Joseph Chalabi <chalabi.joseph@gmail.com>
chalabi2 added 3 commits July 29, 2026 09:37
Update the MCP page for the two-rail server: Console tools register
whenever an API key resolves, the server runs without a chain context on
a managed setup, and read tools are annotated read-only so clients can
auto-approve them. Replace the stale tool count with the actual
inventory and document the new --console-api-key flag.

Add console notes for client-side log filtering (--tail and the
pod-name-prefix service match), the lease create --manifest contract
(the Console-rendered manifest, not the SDL), and wallet settings
reporting the unconfigured default and creating the record on first
enable. Tracks the akt CLI fixes currently in review.

Signed-off-by: Joseph Chalabi <chalabi.joseph@gmail.com>
expressive-code attaches its stylesheet link to the first code block on
a page. When that block sits inside a client: island (the OS tabs on the
installation guides), the link is stripped during island serialization,
so the page ships unstyled code blocks. Both MDX installation guides
were affected.

Render a hidden Code block in the docs page template so every docs page
carries the expressive-code assets through the regular pipeline,
regardless of where its first fence lives. The Code component requires
the Expressive Code options in ec.config.mjs, so they move there from
astro.config.mjs unchanged.

Signed-off-by: Joseph Chalabi <chalabi.joseph@gmail.com>
Document account-free Console contexts, provider discovery, pagination,
workflow recovery, monitor governance views, and clean MCP shutdown so the
draft guide matches the v0.0.3 release candidate.

Signed-off-by: Joseph Chalabi <chalabi.joseph@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant