makea-cli
给 Makea 同事(admin)、品牌(designer)和工厂(supplier)用的命令行工具,也是 Beeboo agent 的动作面:连的是线上正式环境,装好就能用,不用配环境变量、不用改配置文件。
第一次用时在浏览器里登录一次公司账号,之后在本机保存登录状态,即可查询用户、供应商等(具体能执行哪些命令取决于你的账号权限)。
怎么用(三步)
- 安装(本机需要已安装 Python 3.10 或以上)
- 从本仓库安装(开发 / 内网 clone): 在
makea-cli/目录执行
python3 -m pip install -e .
若提示找不到python3,可改用python。 - 不经过 GitHub: 把本包的 Python 发行版发布到公司私有 PyPI / Artifact Registry 等,同事执行
python3 -m pip install makea-cli(或pipx install makea-cli)即可;无需 clone 仓库。 - 可选 — 用 npm 只占一个全局命令名: 仓库里
npm/makea-cli/是一个 薄封装,npm install -g后会把makea-cli指到python3 -m makea_cli;仍需在同一台机器上先用pip装好同名 Python 包(npm 不会替你安装 Python 依赖)。适合已经用 npm 管理全局工具的团队。
- 登录(只需做一次,或过期后再做)
makea-cli auth
会自动打开浏览器,按公司流程登录即可。完成后可以关掉浏览器标签页。 3. 执行功能(示例)
makea-cli admin list user
makea-cli admin list supplier
makea-cli admin list product-order
makea-cli admin list sampling-order --product <product_reference_id>
makea-cli admin list production-order --product <product_reference_id>
从「产品订单」JSON 下载附件: admin list product-order 返回的每条 result 里已有 user_id 和 available_documents(含 document_id、admin_user_id 等),一般 不必再调单独的 document metadata API。可直接:
若只有 product_reference_id,可用(建议加上设计师 user_id 避免扫全库):
更多子命令与参数:
退出登录(清除本机保存的令牌):
makea-cli auth --logout
登录信息保存在哪
保存在本机当前用户下的应用数据目录里(例如 macOS 常见为 ~/Library/Application Support/makea-cli/,Linux 常见为 ~/.config/makea-cli/),文件名类似 credentials.json。一般不用手动打开。
给技术同事:可选环境变量
日常同事 不需要 看本节。只有要连 非线上 或 自建环境 时,才用环境变量覆盖内置地址(默认值在 makea_cli/config.py 里):
| 变量 | 说明 |
|---|---|
MAKEA_API_BASE_URL |
API 根地址(无末尾 /) |
MAKEA_COGNITO_DOMAIN |
Cognito Hosted UI 的主机名(不要写 https://) |
MAKEA_COGNITO_CLIENT_ID |
Cognito 应用客户端 ID |
MAKEA_REDIRECT_URI |
OAuth 回调地址,默认 http://127.0.0.1:8250/callback |
命令一览(0.2 语法)
makea-cli <persona> <verb> <noun> [参数] [--flags]。persona 说明谁在操作(admin / designer / supplier,后端按你的 token 校验;CLI 在发请求前也先比对本机登录的用户类型,不匹配 exit 3);verb 说明读还是写:list get search download 是读,create update delete submit upload send set generate backfill 是写。
每条命令都有的开关:--describe 打印它的机器可读定义(flags、副作用、审批档位);--json 强制纯 JSON(stdout 不是终端时默认就是)。读命令还有 --fields a,b,c 只保留这些字段;list 命令还有 --limit N(后端自己分页的就透传,不分页的在本地截断并在结果里写明 truncated / returned / omitted);写命令还有 --dry-run(打印将要发出的请求,不发)和 --idempotency-key <k>。makea-cli --describe --json 打印全量 manifest。
写命令的审批档位(manifest 的 approval)是给 harness 的建议,不是 CLI 的门:auto 可以自动跑;ask 必须先让人确认;never agent 不许自己决定(人在终端照常能跑)。动钱的端点(payments / bank transfer / subscription)故意不进 CLI。
exit code:0 成功 · 2 用法错 · 3 未登录或身份与 persona 不匹配 · 4 后端拒绝(4xx,错误 JSON 在 stderr)· 5 没跑完(5xx / 网络 / 超时)——读命令直接重试即可;写命令可能已经生效了,重试前先读一遍状态。
0.1 的平铺命令名(list-users、submit-supplier-quote …)仍可用,作为隐藏的过渡别名转发到新命令并在 stderr 打一行提示;下一个 minor 版本删除。完整的改名对照表在 CHANGELOG.md。
admin
| 命令 | 读/写 | 后端 | 说明 | 旧名 |
|---|---|---|---|---|
makea-cli admin backfill supplier-id |
write(never) | POST /admin/supplier/backfill_supplier_id_with_quote_requests |
Migrate supplier_id from a wrong UUID to the Cognito user sub (user_id): profile + Cognito supplierReferenceId, optio… | backfill-supplier-id |
makea-cli admin create consignment |
write(ask) | POST /admin/{production_orders|shipping_orders}/{id}/consignments |
add one lot leaving the factory with its own tracking number, pieces, cartons, kg and ship date. The lot that brings the pieces up to the order is marked last unless --last/--not-last says. |
— |
makea-cli admin create feature-flag |
write(ask) | POST /admin/feature-flags |
add a flag (off unless --enabled). An existing key is refused. | — |
makea-cli admin create library-element |
write(auto) | POST /admin/designer/{user_id}/library_components |
save a reusable component under a designer. Provide --section and --values (see admin get library-schema). | library-create |
makea-cli admin create product-note |
write(ask) | POST /admin/products/{product_id}/notes |
write a note on a product. Without --internal it goes to the brand. | — |
makea-cli admin create quote-request |
write(ask) | POST /admin/supplier/create_quote_request |
create/send a quote request to a supplier for a product (admin). Held (409 FILES_DISAGREE) while the brand's files disagree; --release-anyway sends regardless. | create-quote-request |
makea-cli admin create quote-request-note |
write(ask) | POST /admin/quote_requests/{quote_request_id}/reply_status_note |
write to the factory on a quote request (e.g. answer its clarification). --requirements-updated words the email as a change to the product's requirements. | — |
makea-cli admin create ship-log |
write(ask) | POST /admin/ship-log/deploys |
record a change going live on the admin Ship log, after the deploy succeeded: Jira key (or no-jira), --kind feature|fix, plain title and summary for the team, commits, Amplify job or EB version, optional --watch note and --media recordings or screenshots. |
— |
makea-cli admin create rule |
write(ask) | POST /admin/playbook/{target}/rules |
add a rule to a person's (--user, user_id or email), a factory's (--supplier) or the platform-wide (--global, max 30 live) AI playbook; admin-authored, active unless --status. Refuses a repeat or a conflict unless --force. --reason required; --why / --proof are what the brand reads under it, --title its card name. |
— |
makea-cli admin create shipping-fee |
write(ask) | POST /admin/shipping_orders/{shipping_order_id}/fees/add |
add a fee (fixed amount or percentage) on top of the freight. | — |
makea-cli admin create shipping-option |
write(ask) | POST /admin/shipping_orders/{shipping_order_id}/shipping-options |
add one freight quote (provider, speed, price, currency). | — |
makea-cli admin create shipping-order |
write(ask) | POST /admin/shipping_orders/create |
make a shipment for a brand's production and/or sampling orders. The shipment belongs to the orders' owner; you are r… | — |
makea-cli admin create supplier |
write(ask) | POST /admin/supplier/add_supplier |
create supplier from JSON file (admin). Run makea-cli get-supplier-profile-schema FIRST to get the field taxonomy (… |
add-supplier |
makea-cli admin create supplier-link |
write(ask) | POST /admin/product/link_supplier |
assign a factory to a product, with no price. A bare assignment is not a quote: no quote email goes out and nothing is priced. To quote, use admin submit quote on the quote request. | — |
makea-cli admin create user |
write(never) | POST /admin/users/create |
register a user and confirm the Cognito account in one step (no verification email). Allowed --user-type values: "Fas… | create-user |
makea-cli admin delete about |
write(ask) | DELETE /admin/about/{target}/{key} |
remove one About you line (--user / --supplier); it is not guessed again. --reason required. |
— |
makea-cli admin delete consignment |
write(ask) | DELETE /admin/{production_orders|shipping_orders}/{id}/consignments/{consignment_id} |
remove a lot entered by mistake. A delivered lot cannot be removed. | — |
makea-cli admin delete ship-log |
write(ask) | DELETE /admin/ship-log/deploys/{deploy_id} |
remove a Ship log entry recorded by mistake, with its recordings. | — |
makea-cli admin delete feature-flag |
write(ask) | DELETE /admin/feature-flags/{key} |
remove a flag. Every check of it then reads false, so delete it only once the code that reads it is gone. | — |
makea-cli admin delete library-element |
write(never) | DELETE /admin/designer/{user_id}/library_components/{component_id} |
remove a component from the designer's org library. | library-delete |
makea-cli admin delete rule |
write(ask) | DELETE /admin/playbook/{target}/rules/{rule_id} |
remove a rule (--user / --supplier / --global): archived, with who and why kept on it (update rule --status active restores it). --reason required. |
— |
makea-cli admin delete shipping-fee |
write(ask) | DELETE /admin/shipping_orders/{shipping_order_id}/fees/{fee_id}/remove |
remove one fee. | — |
makea-cli admin delete shipping-option |
write(ask) | DELETE /admin/shipping_orders/{shipping_order_id}/shipping-options/{shipping_option_id}/remove |
withdraw one freight quote. | — |
makea-cli admin delete shipping-order |
write(never) | DELETE /admin/shipping_orders/{shipping_order_id}/delete |
remove a shipment and free its orders. Graded never: the backend does not check status, so it removes a paid or in-transit shipment too. |
— |
makea-cli admin delete shipping-order-item |
write(ask) | POST /admin/production_orders/{id}/unlink_from_shipping_order/{shipping_order_id} |
take one production or sampling order off a shipment. A shipment left empty is deleted. | — |
makea-cli admin delete supplier-link |
write(ask) | POST /admin/product/unlink_supplier |
remove a supplier link from a product. --link-id removes one link; --supplier removes every link that supplier has on the product. | — |
makea-cli admin download document |
read | GET /admin/document/download |
save a document file (document id + designer user_id). | download-document |
makea-cli admin download product-document |
read | GET /admin/document/download |
Resolve product via admin list product-order payload, then GET /admin/document/download. | download-product-document |
makea-cli admin generate about |
write(auto) | POST /admin/about/{target}/refresh |
recount an account's About you now; --read also reads its conversations (one model call). |
— |
makea-cli admin generate pricing-groups |
write(ask) | POST /admin/production_orders/{id}/details/update |
Lay a production order's variants into pricing groups along one axis (--by style | colour | variant | all) with th… | production-groups-generate |
makea-cli admin get about |
read | GET /admin/about/{target} |
one account's About you (--user: a supplier account's person gets their factory's page; --supplier): facts, removed, unknown, paused, topic keys. |
— |
makea-cli admin get active-users |
read | POST /admin/analytics/query |
Distinct active users per day over the last N days (DAU series). | analytics-active-users |
makea-cli admin get analytics-query |
read | POST /admin/analytics/query |
Run an arbitrary HogQL query (escape hatch). Example: analytics-query "SELECT count() FROM events" | analytics-query |
makea-cli admin get file |
read | local (makea_cli.file_reader) | read a pattern (DXF/RUL/PLT), artwork (AI/EPS/PSD/SVG), embroidery (PES/DST/EMB), ZIP or AVIF/TIFF file on this machine; saves PNG pictures of what it draws next to it. No API call. | — |
makea-cli admin get currency-conversion |
read | GET /admin/fx/rates |
the platform's own exchange rates and rounding (rate table for several --from; one --from with --amount converts it). | convert-currency |
makea-cli admin get feature-usage |
read | POST /admin/analytics/query |
How many distinct users used a feature recently, plus event volume. Matches $pageview path and feature_time_spent eve… | analytics-feature-usage |
makea-cli admin get growth-snapshot |
read | GET /admin/growth/snapshots/{id} |
one reconciled Growth Analysis snapshot (default latest); --block prints one block (headline, gates, review_items, …). |
— |
makea-cli admin get library-schema |
read | GET /admin/library_components/schema |
the tech-pack library taxonomy: sections and their library-role field keys (run this before create/update). | library-schema |
makea-cli admin get playbook-preview |
read | GET /admin/playbook/preview |
the playbook block one AI surface would get for a person or factory, and every rule left out with its reason; --product previews a conversation about one product, --rule answers for one rule. | — |
makea-cli admin get product-status |
read | GET /admin/products/{product_id}/status |
where the product is: stage · step · owner for each supplier on it (the shared status model), plus the step catalog. | — |
makea-cli admin get product-step |
read | GET /admin/products/{product_id}/suppliers/{supplier_id}/change_step |
the step one factory is at on a product and the steps admin update product-step can move it to (options; money steps are listed but never selectable). | — |
makea-cli admin get production-order |
read | GET /admin/production_orders/{production_order_id}/details |
one production (or restock) order in full: items, status, progress steps, tracking, notes, documents and linked suppliers. For only its pricing use admin get production-pricing. | — |
makea-cli admin get production-pricing |
read | GET /admin/production_orders/{id}/details |
show a production order's price tiers, MOQ, sizes/colours, pricing groups and cart coverage. | production-pricing-show |
makea-cli admin get quote-request |
read | GET /admin/quote_requests/{quote_request_id} |
one quote request in full. | — |
makea-cli admin get rule |
read | GET /admin/playbook/{target}/rules/{rule_id} |
one rule in full (--user / --supplier / --global), with its evidence: where it came from, who changed it and why. |
— |
makea-cli admin get rule-history |
read | GET /admin/playbook/rules/{rule_id}/history |
every revision of one rule: its words, who changed it and why, and the rule that replaced it. | — |
makea-cli admin get shipping-order |
read | GET /admin/shipping_orders/{shipping_order_id}/details |
one shipment with its production and sampling orders, freight quotes, fees, tracking and address. | — |
makea-cli admin get supplier |
read | GET /admin/supplier/get_supplier_by_id |
one supplier's full profile (contact, capabilities, documents) plus its financial documents. | — |
makea-cli admin get supplier-profile-schema |
read | GET /admin/supplier/profile/schema |
supplier profile v2 schema (section/field taxonomy: sections, fields, options, required rules). | get-supplier-profile-schema |
makea-cli admin get task |
read | GET /admin/tasks/{task_id} |
one Makea task in full: body, admin link, what settles it, and for a held lesson the finding Beeboo kept. | — |
makea-cli admin get tech-spec-extraction |
read | GET /admin/products/{id}/extract-tech-specifications |
AI-generate specs (not saved). | extract-ai-tech-spec |
makea-cli admin get top-clicks |
read | POST /admin/analytics/query |
which buttons/elements get clicked most. | analytics-top-clicks |
makea-cli admin get top-features |
read | POST /admin/analytics/query |
a quick map of which features get used most. | analytics-top-features |
makea-cli admin get user |
read | GET /admin/user-profiles/{user_id} |
one account's profile (Cognito sub as id). | — |
makea-cli admin list consignments |
read | GET /admin/{production_orders|shipping_orders}/{id}/consignments |
the lots a shipment left the factory in, each with its tracking number, plus counts: pieces ordered, booked and still to ship, and how many lots landed. | — |
makea-cli admin list feature-flag |
read | GET /admin/feature-flags |
every flag: global switch, default value, and the accounts it is on for (id, email, name). | — |
makea-cli admin list library-element |
read | GET /admin/designer/{user_id}/library_components |
list a designer's tech-pack library (org-fanned). Optional --section scopes to one type. | library-list |
makea-cli admin list growth-snapshot |
read | GET /admin/growth/snapshots |
published Growth Analysis snapshots, newest first (the change log). | — |
makea-cli admin list misc-payment |
read | GET /admin/products/{id}/misc-payments |
misc payments for one product (admin). | list-misc-payments-by-product |
makea-cli admin list product-note |
read | GET /admin/products/{product_id}/notes |
the notes Makea wrote to the brand on a product. | — |
makea-cli admin list product-order |
read | GET /admin/designer/get_all_product_orders |
designer product (SKU) list. For 大货 use admin list production-order or admin list production-order --product. | list-product-orders |
makea-cli admin list production-order |
read | GET /admin/production_orders?type=PRODUCTION |
大货 (production) orders only. For restock use admin list restock-order; for shipping use admin list shipping-order. | list-all-production-orders |
makea-cli admin list quote-request |
read | GET /admin/quote_requests |
quote requests, optionally for one product (--product) or one supplier (--supplier, GET /admin/quote_requests/supplie… | — |
makea-cli admin list restock-order |
read | GET /admin/production_orders?type=RESTOCK |
restock orders only. Restock shares the production_orders table; this filters to type=RESTOCK. | list-all-restock-orders |
makea-cli admin list rule |
read | GET /admin/playbook/{target}/rules |
every AI playbook rule for one person (team, own account, factory), one factory (--supplier) or the platform (--global): status, scope, title, text, which products, effect, source. Archived ones only with --all. |
— |
makea-cli admin list sampling-order |
read | GET /admin/sampling_orders/get_all |
paginated list of all sampling orders (admin). | list-all-sampling-orders |
makea-cli admin list shipping-order |
read | GET /admin/shipping_orders |
paginated list of all shipping orders (admin). | list-all-shipping-orders |
makea-cli admin list supplier |
read | GET /admin/supplier/get_all_suppliers |
list all suppliers (admin). | list-suppliers |
makea-cli admin list supplier-link |
read | GET /admin/product/linked_suppliers/by_supplier/{supplier_id} |
direct backend query. | get-supplier-links-by-supplier-id |
makea-cli admin list task |
read | GET /admin/tasks |
the Makea team's open tasks (Beeboo's notes, held lessons, sample price flags, PP samples, brand asks) by kind, with notes; --user adds that account's own account.* cards; --wrong lists the tasks marked wrong instead. |
— |
makea-cli admin list ship-log |
read | GET /admin/ship-log/deploys |
deploys recorded on the Ship log between two days (--since, --until), newest first. |
— |
makea-cli admin list user |
read | GET /admin/users |
list registered users (admin, optional pagination). | list-users |
makea-cli admin send email |
write(ask) | POST /admin/email/send |
queue an HTML email (To required, Cc optional). From must be @makea.co; HTML from --html-file or stdin ('-'). Require… | send-email |
makea-cli admin set pricing-groups |
write(ask) | POST /admin/production_orders/{id}/details/update |
Set a production order's pricing groups from a JSON file, copy them from the order's quote, or clear them (--clear) t… | production-groups-set |
makea-cli admin set production-order-tracking |
write(ask) | POST /admin/production_orders/{production_order_id}/tracking |
the bulk parcel: tracking number, URL, shipping method, carrier, plus cartons and gross weight off the packing list. Only what you pass is changed; an empty string clears a field. | — |
makea-cli admin set production-tiers |
write(ask) | POST /admin/production_orders/{id}/details/update |
Set the order-wide price tiers / MOQ / incoterm / currency on a production order (the schedule used when it has no pr… | production-tiers-set |
makea-cli admin set production-variants |
write(ask) | POST /admin/production_orders/{id}/details/update |
Set a production order's available sizes and colours (the grid the buyer's cart and every pricing group's cart keys a… | production-variants-set |
makea-cli admin set sampling-order-tracking |
write(ask) | PUT /admin/sampling_orders/{sampling_order_id}/tracking |
the sample's parcel: tracking number, URL, shipping method, carrier. Only what you pass is changed; an empty string clears a field. | — |
makea-cli admin submit quote |
write(ask) | POST /admin/quote_requests/{quote_request_id}/submit_quote |
admin submits a new quote (link) to a quote request. Pricing groups cannot be sent here (the submit endpoint ignores … | submit-supplier-quote |
makea-cli admin update about |
write(ask) | PATCH /admin/about/{target}/{key} |
add or reword one About you line (stands as the account's own words); --restore brings a removed one back. --reason required. |
— |
makea-cli admin update about-pause |
write(ask) | POST /admin/about/{target}/pause |
stop (or --resume) Beeboo using an account's About you. --reason required. |
— |
makea-cli admin update feature-flag |
write(ask) | PATCH /admin/feature-flags/{key} |
flip the global switch, edit the description or default value, or add / remove one account on the allow-list (by user id; find it with admin list user). | — |
makea-cli admin update library-element |
write(auto) | PATCH /admin/designer/{user_id}/library_components/{component_id} |
update a component's name and/or values (empty value clears a field). | library-update |
makea-cli admin update product |
write(ask) | PUT /admin/products/{product_id}/basic-info |
change a product's name, category, launch date, contact, size count, grading or custom notes. Only what you pass is changed. Shipping address, sampling sizes and colourways are not covered here. | — |
makea-cli admin update product-document |
write(ask) | POST /admin/designer/update_document_status |
review one of a product's documents: APPROVED, REJECTED, UPLOADED. | — |
makea-cli admin update product-step |
write(ask) | POST /admin/products/{product_id}/suppliers/{supplier_id}/change_step |
move a factory to a step when it happened off the platform. Before production any step can be picked, backwards too; PRODUCE, QC and SHIP only go forward, and a step behind an unpaid payment is refused. Run admin get product-step first for the options. | — |
makea-cli admin update production-order |
write(ask) | PUT /admin/production_orders/{production_order_id}/status |
move a production order to another status (DRAFT, IN_REVIEW, READY_FOR_PRODUCTION, PRODUCTION_IN_PROGRESS, PRODUCTION_COMPLETED, SHIPPED, DELIVERED, COMPLETED, CANCELLED). The paid statuses (PAID, DEPOSIT_PAID, FINAL_PAYMENT_PAID) are recorded by the payment and are refused here. | — |
makea-cli admin update quote |
write(ask) | POST /admin/product/edit_supplier_link_override_info |
admin updates an existing quote (supplier link) in place. Only the options you pass are sent, and the backend leaves … | update-supplier-quote |
makea-cli admin update quote-request |
write(ask) | PATCH /admin/quote_requests/{quote_request_id}/update |
set a quote request's stage, status and/or due date. Only what you pass is changed. This is the door that unblocks a … | update-quote-request |
makea-cli admin update rule |
write(ask) | PATCH /admin/playbook/{target}/rules/{rule_id} |
change a rule's text, status, applies_to, when, mode or end date (--valid-until), the --why / --proof the brand reads, or its card --title, on --user / --supplier / --global. --reason required; the rule keeps what it was before. |
— |
makea-cli admin update sampling-order |
write(ask) | PUT /admin/sampling_orders/{sampling_order_id}/status |
move a sampling order to another status (DRAFT, IN_PROGRESS, SAMPLING_COMPLETED, APPROVAL, SHIPPED, DELIVERED, CANCELLED). PAID is recorded by the payment and is refused here. Prefer admin update product-step, which moves the same statuses through the step model. | — |
makea-cli admin update shipping-order |
write(ask) | PUT /admin/shipping_orders/{shipping_order_id}/status |
Change a shipment: --status (PUT .../status), tracking flags (POST .../tracking), --address (PUT .../shipping-address… | — |
makea-cli admin update supplier |
write(ask) | PUT /admin/supplier/update_supplier |
update an existing supplier from a JSON file (admin). Run makea-cli get-supplier-profile-schema FIRST to get the fi… |
update-supplier |
makea-cli admin update task |
write(ask) | POST /admin/tasks/{task_id}/{done|dismiss|note} |
close a Makea task with a note: --done once handled (a held lesson's --reason goes to Beeboo's next reading), --dismiss, or --dismiss --wrong when it should never have been raised; --note alone adds a note and leaves it open. |
— |
makea-cli admin update consignment |
write(ask) | PUT /admin/{production_orders|shipping_orders}/{id}/consignments/{consignment_id} |
edit one lot; --delivered marks it delivered through the tracking sweep path (a middle lot tells the brand in-app and on WhatsApp, the last one delivers the order); --silent tells nobody. |
— |
makea-cli admin update ship-log |
write(ask) | PATCH /admin/ship-log/deploys/{deploy_id} |
fix a Ship log entry's title, summary or watch note; --media attaches more recordings. |
— |
makea-cli admin update tech-spec |
write(ask) | POST /admin/products/{id}/technical-specifications |
persist specs from a JSON file. | save-product-tech-spec |
makea-cli admin update tracking-status |
write(ask) | POST /admin/tracking/carrier_status |
apply a carrier status looked up by hand (tracking-sweep skill) to one order: status, fan-out, delivered emails (--silent: state only). | — |
makea-cli admin update user |
write(ask) | PUT /admin/user-profiles/{user_id}/update |
admin updates DynamoDB user profile fields and/or Cognito custom:userType. Allowed --user-type values: "Fashion brand… | update-user-profile |
makea-cli admin upload financial-document |
write(auto) | POST /admin/products/{product_id}/financial_documents |
upload one or more files to AWS S3 and return financial document metadata. | upload-financial-documents |
makea-cli admin upload growth-snapshot |
write(ask) | POST /admin/growth/snapshots |
publish a reconciled snapshot to admin Metrics; the server runs the ten gates and refuses a failure; --check gates only. |
— |
makea-cli admin upload link-document |
write(auto) | POST /admin/upload_link_document |
upload a file to AWS S3 and return document domain metadata for reuse as input in other commands. | upload-link-document |
makea-cli admin upload product-document |
write(auto) | POST /admin/designer/upload_document |
upload a file to AWS S3 under a product and return document domain metadata for reuse by other commands. | upload-product-document |
makea-cli admin upload production-order-document |
write(auto) | POST /admin/production_orders/{production_order_id}/documents |
upload a file to AWS S3 for a production order and return document domain metadata. | upload-production-order-document |
makea-cli admin upload production-progress-document |
write(auto) | POST /admin/production_orders/{production_order_id}/progress/{progress_id}/upload |
upload a file to AWS S3 for production progress and return document metadata. | upload-production-progress-document |
makea-cli admin upload sampling-order-document |
write(auto) | POST /admin/sampling_orders/{sampling_order_id}/documents |
upload a file to AWS S3 for a sampling order and return document domain metadata. | upload-sampling-order-document |
makea-cli admin upload supplier-document |
write(auto) | POST /admin/supplier/upload_document |
upload a supplier document to AWS S3 and return document domain metadata for reuse by other commands. | upload-supplier-document |
designer
| 命令 | 读/写 | 后端 | 说明 | 旧名 |
|---|---|---|---|---|
makea-cli designer create checkout |
write(ask) | POST /designer/payments/basket/create-session |
a Stripe checkout link for one or more charges. --key repeats: sampling:<sampling_order_id>, production:<production_o… | — |
makea-cli designer create collection |
write(auto) | POST /designer/collections/create |
create or update a designer collection. | designer-create-collection |
makea-cli designer create library-element |
write(auto) | POST /designer/library_components |
add a fabric, trim or other part to the brand's library; --document attaches a photo or data sheet, --draft when required fields are unknown. | — |
makea-cli designer create note |
write(ask) | POST /designer/products/{product_id}/notes |
post a message into a product's conversation. | — |
makea-cli designer create pack-file |
write(auto) | POST /designer/products/{product_id}/tech_spec/files |
put an uploaded file on a tech pack section; a pattern file (DXF, RUL, PLT) goes on Patterns when no section is named. | — |
makea-cli designer create product |
write(ask) | POST /designer/product/create_or_update_product |
payload must match manufacture/specifications (all frontend fields; categories/subcategories + collection_id in --hel… | designer-upsert-product |
makea-cli designer create quote-award |
write(ask) | POST /designer/quotes/group_pay_prepare |
choose the supplier quote to sample with. --quote is the supplier link id from designer list supplier-link; repeat … |
— |
makea-cli designer create rfq |
write(ask) | POST /designer/product/send_rfq |
ask the chosen suppliers to quote on a product. --supplier repeats; --makea-sourcing also asks Makea to source. | — |
makea-cli designer create sampling-order |
write(ask) | POST /designer/sampling_orders |
order samples. --file is the full order payload (product_order_id, items, fees …); run --dry-run first and read the b… | — |
makea-cli designer delete sampling-order |
write(never) | DELETE /designer/sampling_orders/{sampling_order_id} |
delete a DRAFT sample order. The backend refuses any other status. Graded never. |
— |
makea-cli designer delete shipping-order |
write(never) | POST /designer/shipping_orders/{shipping_order_id}/cancel |
the endpoint is called cancel but it unlinks every production order and removes the shipment, so it is a delete here.… | — |
makea-cli designer download document |
read | GET /designer/document/download |
save bytes for user_id + document_id (designer-authenticated; same query contract as admin document download). | designer-download-document |
makea-cli designer get file |
read | local (makea_cli.file_reader) | read a pattern (DXF/RUL/PLT), artwork (AI/EPS/PSD/SVG), embroidery (PES/DST/EMB), ZIP or AVIF/TIFF file on this machine; saves PNG pictures of what it draws next to it. No API call. | — |
makea-cli designer get collection |
read | GET /designer/collections/{collection_id}/overview |
one collection with its products, orders and lifecycle in a single read. | — |
makea-cli designer get library-schema |
read | GET /designer/library_components/schema |
the library's sections and each one's field keys, options and required fields. | — |
makea-cli designer get lifecycle |
read | GET /designer/product_orders/{product_order_id}/lifecycle |
which stage this product is in. | — |
makea-cli designer get product |
read | GET /designer/get_product |
one product: status, documents, prices, links. | — |
makea-cli designer get production-price |
read | GET /designer/production_orders/{production_order_id}/calculate_price |
what the deposit (or the balance, --phase final) comes to for the quantities on the run right now, line by line. | — |
makea-cli designer get quote-advice |
read | GET /designer/product/quote_advice |
which quote to award and why, from cache. Reading never spends a model call; the web app is what asks for a fresh one. | — |
makea-cli designer get tech-pack |
read | GET /designer/products/{product_id}/technical-specifications |
the product's tech pack. | — |
makea-cli designer get tech-pack-history |
read | GET /designer/products/{product_id}/specification-change-history |
who changed which spec field, when, and from what. | — |
makea-cli designer list action |
read | GET /designer/actions |
the pending actions on you, optionally for one product. An action is closed by the fact it asks for, not by acknowled… | — |
makea-cli designer list channel |
read | GET /designer/products/{product_id}/channels |
the product's conversation channels. | — |
makea-cli designer list collection |
read | GET /designer/collections |
the brand's collections. | — |
makea-cli designer list library-element |
read | GET /designer/library_components |
the brand's own shelf (fabrics, trims, colours, artwork); --section narrows to one kind. | — |
makea-cli designer list payment |
read | GET /designer/payments |
your charges and whether they are paid. | — |
makea-cli designer list product |
read | GET /designer/get_all_products |
every product you can see (your own and your team's). | — |
makea-cli designer list production-order |
read | GET /designer/production_orders |
your 大货 orders; --product narrows to one product (GET /designer/product_orders/{id}/production_orders). | — |
makea-cli designer list sampling-order |
read | GET /designer/sampling_orders/user |
your sampling orders; --product narrows to one product (GET /designer/product_orders/{id}/sampling_orders). | — |
makea-cli designer list shipping-order |
read | GET /designer/shipping_orders |
your shipments. | — |
makea-cli designer list supplier-link |
read | GET /designer/product/linked_suppliers |
the suppliers linked to one product, with their quotes. | — |
makea-cli designer list task |
read | GET /designer/tasks |
what the platform is waiting on you for. | — |
makea-cli designer search note |
read | GET /designer/products/{product_id}/channel_search |
full-text search across a product's conversation; --channel narrows to one channel key. | — |
makea-cli designer set product-collection |
write(auto) | POST /designer/products/{id}/link-to-collection |
assign product to a collection. | designer-link-product-to-collection |
makea-cli designer set production-cart |
write(auto) | PUT /designer/production_orders/{production_order_id}/cart |
the quantity of every size and colour on the run. Replaces the whole cart: pass every cell you want kept. --qty repea… | — |
makea-cli designer set production-lock |
write(ask) | POST /designer/production_orders/{production_order_id}/configuration-lock |
place the order with the quantities on the run (--unlock to reopen them). Locking is what makes the deposit payable: … | — |
makea-cli designer submit production-order |
write(ask) | POST /designer/production_orders/{production_order_id}/submit |
submit a 大货 order. This is the commitment, so --dry-run and confirm with the user first. | — |
makea-cli designer submit sampling-order |
write(ask) | POST /designer/sampling_orders/{sampling_order_id}/confirm |
confirm a sample order so the supplier starts. Run --dry-run first and read it back to the user. | — |
makea-cli designer submit tech-pack |
write(ask) | POST /designer/products/{product_id}/technical-specifications/confirm |
confirm the tech pack, the step before anyone is asked to quote. | — |
makea-cli designer update action |
write(auto) | POST /designer/actions/{action_id}/{acknowledge|snooze|dismiss} |
respond to one of the pending actions from designer list action. An action is closed by the fact it asks for, not b… |
— |
makea-cli designer update note |
write(ask) | POST /designer/products/{product_id}/notes/{note_id}/{accept|reject} |
decide on a task the assistant proposed on a product. | — |
makea-cli designer update product |
write(auto) | POST /designer/product/update_basic_info |
patch fields on a product. --cover-image / --back-image take a document id and are what the assistant's set_product_i… | — |
makea-cli designer update production-order |
write(ask) | POST /designer/production_orders/{production_order_id}/complete |
POST /designer/production_orders/{id}/complete, or PUT the order to re-pick which supplier links it covers (--links-f… | — |
makea-cli designer create proposal |
write(auto) | POST /designer/products/{product_id}/tech_spec/proposals |
propose a tech-pack change as a card on the field it changes; the user applies it. Name section/field as get tech-pack --readable shows them; --item / --entry pick a row, --was a line. |
— |
makea-cli designer update proposal |
write(ask) | POST /designer/beeboo_proposals/approve |
apply one spec change the assistant proposed. This edits the pack, so read the proposal first. | — |
makea-cli designer update sampling-order |
write(never) | POST /designer/sampling_orders/{sampling_order_id}/cancel |
cancel a sample order. Graded never: an agent must not do this on its own, a person runs it. |
— |
makea-cli designer update shipping-order |
write(ask) | POST /designer/shipping_orders/{shipping_order_id}/confirm_receive |
say the goods arrived. The backend accepts this only while the shipment is IN_TRANSIT. | — |
makea-cli designer update suggested-action |
write(ask) | POST /designer/channels/{channel_id}/suggested_actions/bulk_accept |
accept several of a channel's suggested actions in one write. --action takes note_id:action_id and repeats. | — |
makea-cli designer update task |
write(auto) | POST /designer/tasks/{complete|dismiss} |
close one of the tasks from designer list task. Complete means you did it; dismiss means it does not apply. |
— |
makea-cli designer upload document |
write(auto) | POST /designer/document/upload |
upload a file for the current designer token; optional product_id (omit to start a new draft id server-side). | designer-upload-document |
supplier
| 命令 | 读/写 | 后端 | 说明 | 旧名 |
|---|---|---|---|---|
makea-cli supplier create note |
write(ask) | POST /supplier/products/{id}/channels/{key}/notes |
post a message into a product channel you are part of. | — |
makea-cli supplier download document |
read | GET /supplier/document/download |
save a document you are allowed to read. | — |
makea-cli supplier get file |
read | local (makea_cli.file_reader) | read a pattern (DXF/RUL/PLT), artwork (AI/EPS/PSD/SVG), embroidery (PES/DST/EMB), ZIP or AVIF/TIFF file on this machine; saves PNG pictures of what it draws next to it. No API call. | — |
makea-cli supplier get pack |
read | GET /supplier/quote_requests/{id}/technical-specifications |
the tech pack for an RFQ, as the factory is allowed to see it (--readable: labels, values and blank essentials only). |
— |
makea-cli supplier get pack-changes |
read | GET /supplier/products/{product_id}/specification-change-history |
what changed in the pack since you quoted, field by field. | — |
makea-cli supplier get profile |
read | GET /supplier/profile |
your own supplier profile. | — |
makea-cli supplier get rfq |
read | GET /supplier/quote_requests |
one RFQ in full. | — |
makea-cli supplier list action |
read | GET /supplier/actions |
what the platform is waiting on you for (pending actions). | — |
makea-cli supplier list channel |
read | GET /supplier/products/{product_id}/channels |
the channels you are part of on a product. | — |
makea-cli supplier list note |
read | GET /supplier/products/{product_id}/channels/{channel_key}/notes |
the conversation in one channel. | — |
makea-cli supplier list production-order |
read | GET /supplier/production_orders |
your production orders, optionally for one RFQ. | — |
makea-cli supplier list quote-edit-request |
read | GET /supplier/quote_requests/{quote_request_id}/quote_edit_requests |
changes the brand has asked you to make to a quote you already sent. | — |
makea-cli supplier list rfq |
read | GET /supplier/quote_requests |
the RFQs (quote requests) sent to you. | — |
makea-cli supplier list task |
read | GET /supplier/tasks |
your onboarding and per-order to-dos. | — |
makea-cli supplier submit quote |
write(ask) | POST /supplier/quote_requests/{id}/submit_quote |
submit your quote for an RFQ. --file is the supplier link payload as JSON (same shape the web form posts); run with -… | — |
makea-cli supplier update action |
write(auto) | POST /supplier/actions/{action_id}/{acknowledge|snooze} |
respond to a pending action. Acknowledging says you have seen it; the action still closes on the fact it asks for. | — |
makea-cli supplier update quote |
write(ask) | POST /supplier/quote_requests/{quote_request_id}/links/{link_id}/edit |
revise a quote you already sent. --file is the same payload shape as submit; --dry-run first. | — |
makea-cli supplier update rfq |
write(ask) | POST /supplier/quote_requests/{quote_request_id}/{status|archive|accept_terms} |
answer an RFQ. --status accepts or declines the invitation; --archive takes it off your board; --accept-terms accepts… | — |
makea-cli supplier update task |
write(auto) | POST /supplier/tasks/{complete|dismiss} |
close one of the tasks from supplier list task. |
— |
其它:makea-cli auth [--logout] 登录/登出;makea-cli version 版本号。
大货定价(price tier / 颜色尺码 / pricing group)
一张 production order 的价格由三部分组成:
available_sizes/available_colors— 买家购物车的网格。cart key 是"{尺码},{颜色}",颜色段有 hex 就用hex_code,没有才退回color_name。所以颜色尽量都给 hex。production_price_tiers+moq— 整单一套阶梯价。只在这张单没有 pricing group 时生效。pricing_groups— 若干个各自计价的 cart key 分组。分组回答"谁共用一套价目表",tier_basis/moq_basis回答"按什么量去查这套表"(VARIANT 每个 cart key 各算各的,GROUP 按组内合计,ORDER 按全单合计)。
MOQ 的几种配法就是这两个旋钮的组合:
| 想要的效果 | 命令 |
|---|---|
| 每个 style 自己的阶梯价 + 自己的 MOQ | --by style --moq-basis group |
| 每个颜色一个 MOQ,跨所有 style 累计 | --by colour --moq-basis group |
| 每个颜色 × 尺码单独计价 | --by variant --moq-basis group |
| 全单一套价,MOQ 看全单总量 | --by all --moq-basis order |
阶梯写法:--tier 100-199:7.50 --tier 200-499:7.40 --tier 500+:7.20。结尾的 +(或只写下限)表示不封顶,存成 max_qty=0;后端从低到高选,最后一个够 min_qty 的档位胜出。
单组覆盖:--tier-for 'S=100-199:22.45'、--moq-for 'S=100',等号左边可以写组名、尺码、颜色名或 hex。
例(参考 Lacati 毯子那张报价的形态:三个尺寸各一套价,MOQ 100/组):
makea-cli admin set production-variants <po_id> --sizes S,M,L --customized-color
makea-cli admin generate pricing-groups <po_id> --by style \
--tier-for 'S=100-199:7.50' --tier-for 'S=300+:7.20' \
--tier-for 'M=100-199:22.45' --tier-for 'M=300+:21.85' \
--tier-for 'L=100-199:33.05' --tier-for 'L=300+:32.25' \
--moq 100 --moq-basis group --tier-basis VARIANT --dry-run
几条要记住的:
- 写命令都先打印 plan 再问一次;
--dry-run只看不发,--yes跳过确认。默认打的是生产环境。 - 购物车里有、却没被任何组认领的 cart key,付款时会整单失败(不是按 0 计价)。plan 和保存结果都会把这些 key 列出来。
- 重跑
admin generate pricing-groups会保留同名/同变体旧组的group_id和这次没指定的字段,所以"只改 MOQ"是安全的。 - 已经付过款的单,改这里不会动已经收的钱(发票读冻结值),只影响之后的扣款。
Claude / Cursor skills(可选)
仓库内 .claude/skills/ 下放有面向 agent 的操作说明,例如:
supplier-user-id-migration— 供应商 ID 与 Cognito sub 对齐、与admin backfill supplier-id配套
Metadata
Release files for makea-cli 0.2.35
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| makea_cli-0.2.35.tar.gz | 304.9 kB | Without provenance | Details for makea_cli-0.2.35.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| makea_cli-0.2.35-py3-none-any.whl | Python 3 | none | any | Details for makea_cli-0.2.35-py3-none-any.whl |
Total release size: 494.5 kB
Release files / makea_cli-0.2.35.tar.gz
| Download URL | makea_cli-0.2.35.tar.gz |
|---|---|
| Size | 304.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3023c30aa95a62eec038a5f36e8b63ef61b694e83b4c6cb8adef038fdf05953f
|
|
BLAKE2b-256 checksum How to use checksums |
afc29038177ea775e53257205784b5fe2cff8788ca7c5fb029d577b4d27f709c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / makea_cli-0.2.35-py3-none-any.whl
| Download URL | makea_cli-0.2.35-py3-none-any.whl |
|---|---|
| Size | 189.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
872c10ef7ca05f01c21461bf03b533ed2595ed2468ac432e615deb2cb4744317
|
|
BLAKE2b-256 checksum How to use checksums |
3b73b22a366ac84bd3b8b1fe04840c372e193db7806fceeff9c44ed1ba686a6a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for makea-cli 0.2.35
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.