What AI Agents Need for Literature Management Is a Good CLI

A Zenn article on an interesting discovery: the key to AI agent literature management isn't model capability but providing a good CLI interface.

The author built a literature management CLI toolkit letting agents search, download, organize, and annotate papers. Agent-friendly interface design matters more than model intelligence.

Provides practical experience for the emerging field of 'designing tools for AI agents.'

This article describes the author's experience and key findings in getting AI Agents to manage academic literature.

Initial Attempt

The author first had Claude handle literature management in conversation — searching papers, downloading PDFs, organizing, extracting key info. Results were poor: Agent forgot operations, file paths were chaotic, categorization inconsistent.

Key Insight

The problem wasn't model capability but lack of structured tool interfaces. After providing well-designed CLI tools, effectiveness improved dramatically.

CLI Design Principles

Agent-friendly CLI design principles:

1. **Structured output**: JSON format rather than human-readable tables

2. **Atomic operations**: Each command does one thing

3. **Externalized state**: Current state queryable via commands, not relying on Agent memory

4. **Clear errors**: Error messages include specific causes and suggested fixes

5. **Idempotency**: Same command multiple times produces same result

Toolkit

papers search "transformer attention" --since 2025
papers download arxiv:2501.12345
papers tag 2501.12345 --add "attention,efficient"
papers list --tag attention --sort citations
papers summarize 2501.12345 --format brief
papers export --format bibtex --tag attention

Results

With this CLI, Agent literature management accuracy jumped from ~40% to >90%. Key improvements: categorization consistency, file organization, information extraction quality.

Insight

Designing tools for Agents differs from designing for humans. Agents need structured I/O, atomic operations, explicit state management. Agent Tool Design will become an important engineering discipline.