For AI agents: the complete documentation index is available at https://a3s-lab.github.io/Use/en/llms.txt, the full documentation bundle is available at https://a3s-lab.github.io/Use/en/llms-full.txt, and this page is available as Markdown at https://a3s-lab.github.io/Use/en/guide/index.md.
A3S Use
  • English

      • Getting Started

      A3S Use is the AI Native Package Manager for the A3S ecosystem. It does not replace apt, Homebrew, or WinGet. It manages native tools and cognitive plugins that participate in the A3S capability and security model.

      What is available now

      CapabilityStatus
      Local directories and bounded archivesAvailable in v0.2
      Digest-reviewed releases and TUF registriesAvailable in v0.2
      Native CLI, standard MCP, and content-bound SkillsAvailable in v0.2
      Schema-v3 Tool, MCP, Skill, and UI contractsBaseline implemented on main
      OKF (Open Knowledge Format) knowledge surfaceBundle contract complete; install integration pending
      Complete Plugin Manager apply saga and production host adaptersIn development

      The cognitive plugin contracts are on main, but the complete parent apply saga is still converging. Use the roadmap as the source of truth before production deployment.

      Install a release

      Install the complete, verified release through the A3S CLI:

      a3s install use --source release
a3s use doctor --json
a3s use capabilities --json

      Prebuilt archives are also published on GitHub Releases. Keep each archive's binary, Skills, Dashboard, model assets, licenses, and provenance files together. Copying the facade binary alone does not preserve the complete product surface.

      Try built-in capabilities

      Render a web page to a local file:

      a3s use browser render https://example.com --output page.html

      Run local OCR and return JSON:

      a3s use ocr extract ./scan.png --json

      Inspect the immutable capability snapshot:

      a3s-use capability snapshot --json

      Build from source

      Rust 1.85 or newer is required:

      git clone https://github.com/A3S-Lab/Use.git
cd Use
cargo build --workspace --bins --locked
./target/debug/a3s-use doctor --json

      Run development checks inside the Use repository:

      cargo fmt --all -- --check
cargo test --workspace --all-features --locked
cargo clippy --workspace --all-targets --all-features --locked -- -D warnings

      Install a local package

      An unsigned local directory, .tar.gz, .tgz, or .zip requires explicit trust:

      a3s-use component install acme/calendar \
  --from ./calendar-package \
  --allow-unsigned \
  --json

a3s-use component status calendar --json
a3s-use extension disable acme/calendar --json
a3s-use extension enable acme/calendar --json
a3s-use component uninstall calendar --json

      The package ID is the stable lifecycle identity; a route is only a presentation and dispatch alias. A3S Use preserves native argv, stdin, stdout, stderr, exit status, and standard MCP. It does not add a universal action envelope.

      Next steps