agentero-cli

Manage and inspect a local research vault through the Agentero CLI machine interface.

609|50|Updated Jul 7, 2026
One-click install
npx skills add https://github.com/poco-ai/Agentero --skill agentero-cli-poco-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agentero-cli
Source: https://github.com/poco-ai/Agentero/tree/main/templates/vault/.agents/skills/agentero-cli
Command: npx skills add https://github.com/poco-ai/Agentero --skill agentero-cli-poco-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Research vaults containing papers, notes, and reading marks are hard to operate headlessly or from scripts. This Skill lets an agent use the Agentero CLI as a stable machine interface to list, import, inspect, and annotate papers without BYOA, ACP, or a chat runtime. ## Core Features & Use Cases - Vault and catalog operations: List and get papers, import by arXiv id, DOI, or URL, download assets, parse PAPER.md, tag papers, and export bibliography, all with structured --json output. - Layout and reading marks: Query layout regions (figures, tables) and reading marks for a given paper path, with defined error codes like mark_locate_failed and layout_index_missing for safe retries. - Progressive disclosure workflow: Follow an L0-L4 reading protocol (AGENTS.md, paper list, NOTES.md, layout/marks, PAPER.md, TeX source) to answer questions with minimal context. - Use Case: While scripting a literature review, ask the agent to import an arXiv paper, parse it, list its figures, and read its NOTES.md, all through deterministic CLI calls instead of manual file spelunking. ## Quick Start Ask the agent to run agentero paper list --json to show every paper in the current vault, then pick one to summarize.

Frequently Asked Questions about agentero-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list papers in an Agentero vault from the command line?

Run agentero paper list --json to get compact JSON rows with id, path, and title for each paper. Add --fields or --full only when you need extra catalog columns, and use --pretty only for human reading.

How do I import a paper by arXiv id or DOI with agentero?

Use agentero import id <arxiv|doi|url> --json to add a paper to the vault catalog. Follow up with agentero paper download and agentero paper parse on the returned vault-relative path to fetch assets and generate PAPER.md.

Does the Agentero CLI work on Windows?

Yes, on Windows the binary is agentero-cli, installed via the desktop app's settings page which writes a shim and updates the user PATH. Restart already-running terminals so they pick up the new PATH entry.

Why does agentero return a paper_ambiguous error?

The error occurs when a bare id matches papers under multiple shelves. Retry immediately with a vault-relative path taken from error.details.candidates instead of the bare id.

What should I do when mark_locate_failed or layout_index_missing occurs?

For mark_locate_failed, retry with a longer verbatim quote and never guess coordinates. For layout_index_missing, ask the user to open the paper in Agentero and run Figures analysis rather than inventing bounding boxes.

When should I not use the Agentero CLI?

Do not use it as a chat runtime, to spawn coding agents, or to write lecture-style NOTES.md automatically. Reading and writing notes is the agent's own job or belongs to the separate paper-reader skill.