ai-pdf-filler-cli

ai-pdf-filler-cli

AI PDF Filler CLI

Execute PDF autofill workflows using the installed simplicity-cli command. Prefer direct command execution over manual API calls when this skill applies.

Core Workflow

• Confirm simplicity-cli is installed by running simplicity-cli --help.

• If missing, install the CLI:

• Preferred: uv tool install ai-pdf-filler

• Fallback: python3 -m pip install ai-pdf-filler

• Re-check with simplicity-cli --help.

• Ensure authentication is available (create an account and get API key at https://simplicity.ai):

• Preferred: run simplicity-cli login and paste key in hidden prompt.

• Non-interactive: printf '%s' "$SIMPLICITY_AI_API_KEY" | simplicity-cli login --api-key-stdin.

• Or set env var: SIMPLICITY_AI_API_KEY.

• Choose the autofill path:

• New PDF form: use simplicity-cli new.

• Existing form id: use simplicity-cli existing FORM_ID.

• Wait for completion unless the user explicitly requests async behavior.

• Return the resulting task id, form/document id, and downloaded output path.

Command Patterns

Save API key

simplicity-cli login

printf '%s' "$SIMPLICITY_AI_API_KEY" | simplicity-cli login --api-key-stdin

New form from file with context

simplicity-cli new \
  --form-file ./form.pdf \
  --context "name: John Doe; dob: 1990-07-07"

New form from file with source documents

simplicity-cli new \
  --form-file ./form.pdf \
  --source-file ./w2.pdf \
  --source-file ./id.pdf

New form from URL

simplicity-cli new \
  --form-url "https://example.com/form.pdf" \
  --source-url "https://example.com/source.pdf"

Existing form id

simplicity-cli existing FORM_ID --context "first_name: John; last_name: Smoke; dob: 1990-07-07"

--context is the source data used to fill form fields. Use --instructions only for optional autofill behavior guidance.

Task monitoring

simplicity-cli status TASK_ID
simplicity-cli wait TASK_ID --poll-interval-seconds 2 --max-wait-seconds 1800

Rules and Validation

• Enforce exactly one of --form-file or --form-url for new.

• Require at least one source (--source-file/--source-url) or context (--context/--context-file) for new.

• Treat --context and --context-file as mutually exclusive.

• Treat --instructions and --instructions-file as mutually exclusive.

• Reject --output when --no-download is set.

Execution Preferences

• Use human output mode for interactive runs.

• Use --json for automation or when machine-parseable output is requested.

• Use --no-wait only when user wants async handoff; otherwise wait to completion.

• Use --output when user requests an explicit file path.

Failure Handling

• If simplicity-cli is not found, install ai-pdf-filler first, then retry.

• If auth is missing, instruct running simplicity-cli login (or --api-key-stdin) or setting SIMPLICITY_AI_API_KEY.

• If a task fails, report task id and failure message; do not hide API error details.

• If download fails after successful task completion, still return task/form identifiers.

• For scripting contexts, rerun with --json and surface error.code and error.message.

References

Use references/commands.md for concise templates and option reminders. Weekly Installs348Repositoryaskyourpdf/ai-pdf-fillerGitHub Stars1First SeenFeb 26, 2026Security AuditsGen Agent Trust HubPassSocketPassSnykFailInstalled onclaude-code323cursor84gemini-cli33github-copilot33amp33cline33