fima

name	fima
description	Manage Fima expense reimbursements. Use when someone needs to check the current Fima account, sign in or out, or create, query, invoice, approve, reject, or simulate payment for reimbursement claims.

Fima 财务报销

Use this Skill to operate the local Fima CLI. The CLI talks to a running Fima Web service; default URL is http://127.0.0.1:8000.

Install and verify

Run the bundled installer before the first command. It clones https://github.com/chujianyun/fima-cli.git (branch main) into the user's local data directory and runs the upstream installer. Capture its output as the executable path:

CLI_BIN="$("<skill-directory>/scripts/ensure_fima_cli.sh")"
"$CLI_BIN" -v
"$CLI_BIN" -h

The installer is idempotent. Set FIMA_CLI_INSTALL_ROOT to choose a different local checkout. Set FIMA_CLI_UPDATE=1 only when an explicit refresh of the checked-out CLI is wanted.

If the Fima service is elsewhere, set FIMA_URL for the command or add --url <service-url> before the subcommand. Do not expose passwords, session files, or cookies in output.

Account commands

Always check the current account before performing account-dependent work:

"$CLI_BIN" whoami

Use login to open the browser and complete sign-in in its dedicated login dialog. The CLI polls for the completed browser session and saves its cookie locally; it never accepts a password as a command-line argument. When the browser confirms that CLI login is complete, it is safe to close that browser page:

"$CLI_BIN" login

The default wait is five minutes; use --timeout <seconds> only when a longer or shorter window is needed.

Log out only when requested; it clears the local Fima session cookie:

"$CLI_BIN" logout

Other Fima operations

Do not guess command flags or workflows. First inspect the top-level help, then the specific command's help, and use the documented arguments:

"$CLI_BIN" -h
"$CLI_BIN" <command> -h

This includes reimbursement creation and submission, invoice upload, list/detail queries, manager and finance approvals, payment, and rejection. Confirm any action that submits, approves, rejects, pays, or otherwise changes a reimbursement unless the user has already asked for that specific action.

JSON 参数约定

字段超过两个的命令必须通过 --json 传入单个 JSON 对象；先看命令帮助确认必填字段。create 的必填字段为 title、amount、date；流程命令的必填字段为 id，而 reject 还必须包含 comment：

"$CLI_BIN" create --json '{"title":"客户拜访","amount":280,"date":"2026-07-12"}'
"$CLI_BIN" manager-approve --json '{"id":1,"operator":"李主管","comment":"同意"}'
"$CLI_BIN" reject --json '{"id":1,"operator":"李主管","comment":"请补充发票"}'

list、show 和 upload 可继续使用普通参数。