blank-agentic-cli 0.1.1

CLI scaffolder for agentic AI research projects

blank

blank is a CLI scaffolder for research projects driven by agentic AI workflows.

Install

From PyPI (after release):

pipx install blank-agentic-cli

From GitHub:

pipx install git+https://github.com/shusuke-ioku/blank.git

Usage

blank init
blank init my-project
blank init my-project --project-name "My Project"
blank init my-project --dry-run
blank init my-project --force
blank init my-project --no-agents
blank init my-project --paper-template latex
blank init my-project --paper-template blank

If --paper-template is omitted and you run in a terminal, blank init asks you to choose:

• latex: LaTeX-like Typst starter
• blank: minimal empty Typst file

Generated scaffold

• analysis/scripts/
• analysis/data/
• analysis/output/
• paper/
• idea/
• .codex/project.md with default agent rules
• .codex/config.toml with Zotero + PDF-reader MCP server setup
• .codex/skills/ starter skill set and install scripts
• .claude/ defaults

MCP setup (Zotero + PDF reader)

Generated projects include:

• zotero MCP server via zotero-mcp
• pdf_reader MCP server via uvx markitdown-mcp

Quick local checks:

zotero-mcp --help
uvx markitdown-mcp --help

Development

python3 -m venv .venv
source .venv/bin/activate
pip install -e . pytest
pytest

Release (PyPI)

1. Create PyPI project blank-agentic-cli and enable Trusted Publishing for this GitHub repo.
2. (Optional) Run GitHub Action publish manually with testpypi to verify packaging.
3. Tag a release:

git tag v0.1.0
git push origin v0.1.0

4. The publish workflow builds and uploads to PyPI.