arthack-marketplace CLI tools help reference

gistfile0.txt

# arthack-marketplace CLI Tools Reference

Help output for all `*ctl` commands in the arthack-marketplace project.

---

## aictl

AI chat management CLI. Manage conversations across multiple AI backends.

```
usage: aictl [-h]  ...

AI chat management CLI. Manage conversations across multiple AI backends.

positional arguments:
  
    chat-start  Start a new conversation
    chat-send   Continue an existing conversation
    chat-show   Show full conversation history

options:
  -h, --help    show this help message and exit

Examples:
  aictl chat-start claude
  aictl chat-start claude --role planner
  aictl chat-send --chat-id abc12345 "Hello, how are you?"
  aictl chat-send --chat-id abc12345 "Analyze this" --absolute-file-path /path/to/file.txt
  aictl chat-send --chat-id abc12345 "Hello" --dry-run
  aictl chat-show --chat-id abc12345
```

---

## codectl

Code exploration and analysis CLI for agents.

```
usage: codectl [-h]  ...

Code exploration and analysis CLI for agents. Use these commands to search, navigate, and understand source code in local or remote git repositories.

positional arguments:
  
    build-index         Build and return a comprehensive index of the
                        repository.
    extract-context     Extract surrounding code context for a specific line.
    extract-symbols     Extract code symbols (functions, classes, etc.) from
                        the repository.
    find-dependencies   Analyze and visualize code dependencies within a
                        repository.
    find-usages         Find definitions and references of a specific symbol.
    get-file-content    Get the content of one or more files in the
                        repository.
    get-file-tree       Get the file tree structure of a repository or
                        subdirectory.
    get-git-info        Show git repository metadata (current SHA, branch,
                        remote URL).
    multi-repo-extract-symbols
                        Find or list symbols across multiple repositories.
    multi-repo-find-dependencies
                        Audit dependencies across multiple repositories.
    multi-repo-search-text
                        Search for text/regex across multiple repositories.
    search-grep         Perform literal grep search on repository files.
    search-semantic     Perform semantic search using vector embeddings and
                        natural language queries.
    search-text         Perform a textual search in a local repository.

options:
  -h, --help            show this help message and exit
```

---

## knowctl

Knowledge base CLI for agents.

```
usage: knowctl [-h]  ...

Knowledge base CLI for agents. Browse curated documentation topics or use semantic search to find relevant content with natural language queries.

positional arguments:
  
    sync-topics      Fetch/clone content from topic manifests
    list-topics      List all topics with name and summary
    list-documents   List all documents in a topic with summaries
    show-document    Show full content of a document
    semantic-search  Semantic search within a topic using Claude

options:
  -h, --help         show this help message and exit
```

---

## packagectl

Package search CLI for agents.

```
usage: packagectl [-h]  ...

Package search CLI for agents. Use these commands to search package source code and documentation via Chroma and Context7 APIs.

positional arguments:
  
    grep      Regex search in package source code
    hybrid    Semantic search with optional regex filtering
    read      Read a file from a package
    research  Deep research on a package (docs + source + LLM)

options:
  -h, --help  show this help message and exit

Examples:
    packagectl grep numpy "def fft" --max-results 5
    packagectl hybrid django "authentication middleware"
    packagectl read requests requests/models.py --start-line 1 --end-line 50
    packagectl research fastapi --query "How do I implement OAuth2?"

Configuration:
    API keys can be set via environment variables or ~/.config/packagectl/env
```

---

## scrapectl

Web scraping CLI for agents.

```
usage: scrapectl [-h] [--selector SELECTOR] [url] [destination]

Web scraping CLI for agents. Fetch a URL with a headless browser and convert the content to markdown.

positional arguments:
  url                  URL to scrape
  destination          Output file path (defaults to stdout)

options:
  -h, --help           show this help message and exit
  --selector SELECTOR  CSS selector to extract (default: body)
```

---

## searchctl

Web search CLI for agents.

```
usage: searchctl [-h]  ...

Web search CLI for agents. Use this tool to find current information from the web using AI-grounded search via Perplexity.

positional arguments:
  
    raw       Raw search results (no AI processing)
    models    List available models

options:
  -h, --help  show this help message and exit

Examples:
  searchctl "What is quantum computing?"           AI-grounded search
  searchctl "query" -m sonar --context high        Custom model and context
  searchctl raw "AI news" --recency week           Raw search results
  searchctl models                                 List available models
```

---

## summaryctl

Summarization CLI for agents.

```
usage: summaryctl [-h] [file]

Summarization CLI for agents. Generate concise 1-2 sentence summaries of text content using Claude.

positional arguments:
  file        File to summarize (reads from stdin if not provided)

options:
  -h, --help  show this help message and exit
```