UX: arkcli doesn't suggest switching profile when plan quota exceeded
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 64/100
Research direction
Start with the arkcli +chat error path and the arkcli profile list and profile-switching commands. Trace how API errors and configured profiles are represented, then define completion as detecting quota exhaustion and showing available alternatives with reset or billing details and the documented switch commands. Verify the behavior using a quota-exhausted profile and configured alternative profiles.
Written by the indexing model from the issue text.
Description
Problem
When the current default driving plan (e.g., coding-plan) exceeds its usage quota, arkcli +chat and other LLM-driving features fail with a raw API error. The CLI does not inform the user about alternative profiles that may still be available.
Repro
- Use a profile whose plan has exceeded quota (e.g.,
coding-plan_cn-beijing_personal) - Run
arkcli +chat "any message" - See a hard error:
arkruntime.create_responses: arkruntime: API error: You have exceeded the 5-hour usage quota. It will reset at 2026-06-27 12:13:19 +0800 CST. We recommend upgrading your plan for more quota, or waiting for the reset.
Expected behavior
When a quota-exhausted API error is returned, arkcli should:
- Detect the quota-exceeded error from the API response.
- Check if the user has other profiles configured (e.g.,
platformoragent-plan) that likely have separate quotas. - Display a clear actionable suggestion, for example:
Your current plan "Coding Plan Pro" has exceeded its 5-hour quota (resets at 2026-06-27 12:13).
You have other profiles available that may still have quota:
- Agent Plan Medium (
agent-plan_cn-beijing_personal) — expires 2026-07-24- 控制台按量 (
platform_cn-beijing_accountwide) — pay-as-you-goSwitch with:
arkcli profile use <profile-name>
Or set a different default:arkcli config set default_profile <profile-name>
Why it matters
Without this, users hit a dead end, don't know why it failed, and don't realize they have alternative profiles with separate quota — effectively making the CLI unusable when the primary plan is exhausted, even though working alternatives exist.
Relevant context
arkcli profile list
lists 3 profiles: coding-plan (default, exhausted), agent-plan, platform (pay-as-you-go). The latter two likely have separate, unused quota.
- Dominant language
- Go
- Stars
- 133
- Forks
- 13
- Avg merge
- 2m
- Merged PRs (30d)
- 2
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from volcengine/ark-cli
-
[BUG] Responses API:tools 含 web_search 声明时,deepseek 将 function_call_output 误读为用户消息,多轮工具对话可形成死循环 Open
Difficulty 4/5 3-5 days Newbie friendliness 45/100
volcengine/ark-cli#26 · 1 comment ·
-
Difficulty 4/5 3-5 days Newbie friendliness 52/100
volcengine/ark-cli#25 · 1 comment ·
-
[UX] postinstall silently injects 25 arkcli skills into every detected AI agent — should be opt-in Open
Difficulty 4/5 3-5 days Newbie friendliness 52/100
volcengine/ark-cli#24 · 1 reaction ·
-
Difficulty 4/5 3-5 days Newbie friendliness 45/100
volcengine/ark-cli#16 · 1 comment ·
-
Difficulty 4/5 3-5 days Newbie friendliness 52/100
volcengine/ark-cli#15 ·
All issues in volcengine/ark-cli
Similar issues
-
kind/bug needs-triage
Difficulty 1/5 Under an hour Newbie friendliness 72/100
matrixorigin/matrixone#29223 ·
-
needs-acceptance wg/data-plane-networking
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
vllm-project/semantic-router#4024 · 1 comment ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 86/100
alexgorbatchev/dotfiles#107 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 84/100