Skip to main content
╭──────────────────────────────────────────────────────╮
│                                                      │
│   ▄▀█ █▀█ █▀▀ █▀▀ █   █                            │
│   █▀█ █▀▄ █▄▄ █▄▄ █▄▄ █                            │
│                                                      │
│   Unified Command-Line Interface                     │
│   for the Arc Agent Platform                         │
│                                                      │
├──────────────────────────────────────────────────────┤
│  LLM · Agent · Run · Team · Memory · Init Wizard    │
╰──────────────────────────────────────────────────────╯

The single CLI for the entire Arc stack. ArcCLI wraps ArcLLM (provider-agnostic LLM calls), ArcRun (agentic runtime loop), ArcAgent (agent orchestration), and ArcTeam (multi-agent collaboration) into one unified arc command.


Installation

pip install arccli

Development install (install dependencies first):

pip install -e ../arcllm
pip install -e ../arcrun
pip install -e ../arcagent
pip install -e ../arcteam
pip install -e .

Requirements: Python 3.12+


Quick Start

# --- Initialize ---
arc init                                  # tier-based setup wizard (open/enterprise/federal)
arc llm init --tier enterprise            # LLM-specific config setup

# --- LLM ---
arc llm providers                         # list providers
arc llm call anthropic "Hello"            # make an LLM call
arc llm validate                          # check configs and API keys

# --- Agent ---
arc agent create my-agent                 # scaffold agent directory
arc agent build my-agent                  # interactive onboarding wizard
arc agent chat my-agent                   # interactive REPL
arc agent chat my-agent --task "2+2?"     # one-shot task
arc agent bio_memory status               # biological memory overview

# --- Run ---
arc run task "What is 2+2?" --with-calc   # one-shot with tools
arc run exec "print(2 + 2)"              # sandboxed Python execution

# --- Team ---
arc team init                             # initialize team data directory
arc team status                           # team overview
arc team send --to agent://analyst "Hello" # send message
arc team memory search "vendors"          # search team knowledge

Command Groups

Group Purpose
arc init Tier-based initialization wizard (open/enterprise/federal)
arc llm LLM provider management, model discovery, direct calls, init
arc agent Agent lifecycle — create, configure, run, inspect, bio memory
arc run Direct ArcRun execution without an agent directory
arc team Team messaging, memory management, status
arc ext Extension management
arc skill Skill listing

arc init

Unified initialization wizard with tier-based module presets:

Tier Modules Enabled
open All modules disabled — minimal setup
enterprise Telemetry, audit, retry, fallback, rate limiting
federal Full security: routing, PII redaction, signing, OpenTelemetry, budget enforcement
arc init                          # interactive tier selection
arc init --tier federal           # direct tier selection

arc llm

Command Description
arc llm init ArcLLM-specific setup with tier presets
arc llm version Show version info
arc llm config Show global ArcLLM configuration
arc llm providers List all available providers
arc llm provider NAME Show provider details and models
arc llm models List all models across providers
arc llm call PROVIDER PROMPT Make an LLM call
arc llm validate Validate configs and API keys

arc agent

Command Description
arc agent create NAME Scaffold a new agent directory
arc agent build [PATH] Interactive onboarding wizard (or --check to validate)
arc agent chat [PATH] Interactive REPL or one-shot (--task)
arc agent tools [PATH] List all tools available to an agent
arc agent config [PATH] Show agent configuration
arc agent strategies List available execution strategies
arc agent events List all event types emitted by ArcRun
arc agent bio_memory status Biological memory overview
arc agent bio_memory identity Agent identity and traits
arc agent bio_memory episodes Long-term episodic memories
arc agent bio_memory working Current working memory

arc run

Command Description
arc run task PROMPT Run a one-shot task with ArcRun directly
arc run exec CODE Execute Python code in a sandboxed subprocess
arc run version Show ArcRun/ArcLLM versions and capabilities

arc team

Command Description
arc team init Initialize team data directory (entities, channels, HMAC key)
arc team status Team overview (entities, channels, messages, audit)
arc team config Show team configuration
arc team register ID Register an agent or user
arc team send Send a message
arc team inbox Check inbox
arc team drain Drain inbox, mark all read
arc team read Read channel/DM history
arc team thread ID View message thread
arc team actions View pending action items
arc team memory status Team memory status
arc team memory entities List entities (with type filter)
arc team memory entity ID Show entity details
arc team memory search QUERY BM25 search with wiki-link traversal
arc team memory rebuild-index Force full index rebuild
arc team memory config Show memory configuration

Agent Directory Structure

my-agent/
  arcagent.toml          # Agent configuration (model, tools policy, telemetry)
  workspace/
    identity.md          # System prompt (required)
    policy.md            # Behavioral constraints (optional)
    context.md           # Additional context (optional)
  tools/
    __init__.py
    example.py           # Tool definitions (exports get_tools())

Output Format

Every command supports --json for machine-readable output. Full reference: docs/CLI.md.

arc llm providers --json         # JSON array of providers
arc team status --json           # JSON team status object
arc team memory search "q" --json  # JSON search results

License

This project is licensed under the Apache License, Version 2.0.

Copyright (c) 2025-2026 BlackArc Systems.

Metadata

Release files for arccmd 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for arccmd 0.2.0
File Size Uploaded Provenance Actions
arccmd-0.2.0.tar.gz 51.1 kB With provenance Details for arccmd-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for arccmd 0.2.0
File Interpreter ABI Platform Actions
arccmd-0.2.0-py3-none-any.whl Python 3 none any Details for arccmd-0.2.0-py3-none-any.whl

Total release size: 102.3 kB

Release files / arccmd-0.2.0.tar.gz

Download URL arccmd-0.2.0.tar.gz
Size 51.1 kB
Tags Source
SHA-256 checksum
How to use checksums
7ce9d168d165dd17c60bc0b444b37eb8f9fb1ba02805c25a1fac002360d1bd3a
BLAKE2b-256 checksum
How to use checksums
2188bc4596fcec0b13b4b0354bb740c2d67e4caf2f61c85df0e79878f1047fd3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Feb 25, 2026.

Transparency log

Release files / arccmd-0.2.0-py3-none-any.whl

Download URL arccmd-0.2.0-py3-none-any.whl
Size 51.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
79461d74d3a32d0e45ca2818a84d54bf0082dacd5e8550e56c1f01843b4a67d0
BLAKE2b-256 checksum
How to use checksums
4971b6664765b470ae8db424d82c9456805b59210938b369d3007ee15cf9c25a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Feb 25, 2026.

Transparency log

Security for arccmd 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for arccmd-0.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Feb 25, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page