Skip to main content
StableAdapters

CLI (bare) Adapter

The generic CLI adapter wraps any command-line AI coding tool that doesn't have a dedicated adapter. It works with the FORG agent binary and captures session metadata from the terminal environment.

Install

forg connect cli

How it works

The CLI adapter integrates with your shell environment to detect when an AI coding tool is running. It uses environment variables and process inspection to attribute sessions to the correct tool, even without a dedicated adapter.

Use cases

  • Custom or homegrown AI coding CLIs
  • Tools not yet covered by a dedicated adapter
  • Experimental or preview tools

Verification

After installation, run forg status to confirm the adapter is active. Sessions will be attributed based on the active CLI tool.

Capabilities

  • Generic CLI detection
  • Session boundaries
  • Environment-based attribution
  • Metadata-only capture
© 2026 FORG by UpgradIQ, Inc. All rights reserved.Edit this page on GitHub