All Insights
Analysisagentic clis8 min

The Command Line as Investigation Platform

Michael Peterson
Michael PetersonDirector
·

The command line has always been the power user's environment. But until recently, CLI workflows were fundamentally reactive: the human decides, the terminal executes. Agentic CLI frameworks invert this relationship, turning the terminal into an autonomous investigation platform.

From Commands to Conversations

Traditional OSINT workflows are command-driven. The analyst types a command, reads the output, decides the next command. Each step requires human cognition — parsing results, identifying leads, selecting the next tool.

Agentic CLIs operate conversationally. The analyst describes an objective: "Investigate the infrastructure behind domain X." The agent translates this into a sequence of tool calls, evaluates results, and adapts its approach based on what it finds.

This isn't a minor workflow improvement. It's a category change in how investigations are conducted.

The Investigation Loop

A traditional investigation follows a human-driven loop:

Analyst → Command → Output → Analysis → Next Command

An agentic investigation follows a different pattern:

Objective → Agent Planning → Tool Execution → Result Evaluation → Adaptive Next Step

The human remains in the loop at the strategic level (defining objectives, validating conclusions) but exits the tactical loop (choosing tools, parsing output, deciding next steps).

Capabilities That Enable Investigation

Several capabilities make agentic CLIs viable investigation platforms:

Context Maintenance

The agent maintains a running model of what it's learned. When it discovers that domain X resolves to IP Y, it carries that knowledge forward and uses it to inform subsequent queries.

Tool Composition

Investigation tools rarely operate in isolation. DNS results feed into port scanning. Port scanning results feed into service identification. Service identification feeds into vulnerability assessment. Agentic CLIs compose these tools into coherent workflows.

Hypothesis Testing

Advanced agentic CLIs can formulate and test hypotheses. "The registration pattern suggests these three domains are controlled by the same entity — let me check WHOIS history and hosting overlap to confirm."

Documentation as Byproduct

In a traditional investigation, documentation is a separate task that competes with investigation time. In an agentic workflow, documentation is a byproduct — every step is logged, every decision recorded.

Architectural Considerations

Building an investigation platform on agentic CLIs requires:

  • Tool inventory: A curated set of investigation tools the agent can call
  • Permission boundaries: Clear limits on what the agent can do autonomously vs. what requires human approval
  • Evidence handling: Integration with evidence preservation infrastructure (hashing, timestamping, WORM storage)
  • Audit logging: Immutable record of every action for chain of custody

Limitations and Risks

Agentic investigation platforms are not without risk:

  • Over-reliance on automation: An agent that follows a lead down a rabbit hole wastes resources
  • Black box investigations: If the agent's reasoning isn't transparent, the investigation's methodology can be challenged
  • Scope discipline: Autonomous agents need hard limits to prevent unauthorized collection
  • Adversarial awareness: Targets aware of automated OSINT can deploy countermeasures

TCI's Position

We view agentic CLI tools as infrastructure — not replacements for investigators, but force multipliers. The investigator defines the mission. The agent handles execution. The evidence infrastructure ensures everything is preserved and auditable.

The organizations that adopt this model earliest will have a significant advantage in throughput, consistency, and documentation quality.

Michael Peterson

Written by

Michael Peterson

Director, The Commonlight Initiative

Need help with your evidence infrastructure?

TCI builds capture pipelines, redaction workflows, and air-gapped processing systems for organizations handling sensitive data.