Personal Context CLI Workflow

Overview

Use this skill to operate Personal Context CLI with direct commands. Do not rely on local wrapper scripts.

One-Time Install

pipx install "git+https://github.com/WangLiquan/personal-context-cli.git@v0.1.1-beta"

Use one explicit password for the profile and pass it with --password.

Core Workflows

1) Initialize encrypted store

personal-context init \
  --data-file ./profile.enc \
  --password "<YOUR_PASSWORD>"

2) Maintain owner profile and preferences

personal-context profile set \
  --data-file ./profile.enc \
  --password "<YOUR_PASSWORD>" \
  --age 32 \
  --industry internet \
  --income-range 50-100w

personal-context prefs set \
  --data-file ./profile.enc \
  --password "<YOUR_PASSWORD>" \
  --response-style brief \
  --strategy-style balanced \
  --locale-bias CN-first

3) Maintain family members

personal-context family add \
  --data-file ./profile.enc \
  --password "<YOUR_PASSWORD>" \
  --relation spouse

personal-context family list \
  --data-file ./profile.enc \
  --password "<YOUR_PASSWORD>"

4) Preview context and ask

For ask workflows, do not ask users to classify the question type or provide structured type parameters.

personal-context context preview \
  "Should I increase my emergency fund?" \
  --data-file ./profile.enc \
  --password "<YOUR_PASSWORD>"

personal-context ask \
  "Should I increase my emergency fund?" \
  --provider auto \
  --relay-timeout-seconds 45 \
  --relay-retries 1 \
  --data-file ./profile.enc \
  --password "<YOUR_PASSWORD>"

Provider Modes

• auto (default): try codex first, then claude
• codex: force relay to codex exec
• claude: force relay to claude -p

Troubleshooting

• personal-context: command not found:
  • Ensure pipx bin path is in PATH.
• relay timeout:
  • Increase --relay-timeout-seconds to 45 or 60.
• decrypt failure:
  • Verify --password and --data-file pair.

Verification

cd $PROJECT_ROOT
PYTHONPATH=src .venv/bin/pytest -v

References

For command recipes and expected outputs, read:

• references/command-recipes.md