/ 
Acme-Claude-Shell-0.02
/ Acme::Claude::Shell::Query

NAME

Acme::Claude::Shell::Query - Single-shot query mode for Acme::Claude::Shell

SYNOPSIS

use Acme::Claude::Shell::Query;
use IO::Async::Loop;

my $loop = IO::Async::Loop->new;

my $query = Acme::Claude::Shell::Query->new(
    loop      => $loop,
    dry_run   => 0,
    safe_mode => 1,
);

my $result = $query->run("find all large log files")->get;

DESCRIPTION

Executes a single natural language command using Claude's query() function. Does not maintain session context between calls - each run() is independent.

Uses Claude::Agent SDK features:

  • query() - Single-shot prompt execution

  • SDK MCP tools - execute_command, list_files, read_file

  • Hooks - Safety confirmation before command execution

  • CLI utilities - Spinners and colored output

AUTHOR

LNATION, <email at lnation.org>

LICENSE AND COPYRIGHT

This software is Copyright (c) 2026 by LNATION.

This is free software, licensed under:

The Artistic License 2.0 (GPL Compatible)