Skip to content

docs: add ccx to community projects #1942

Closed

Description

@AaronWong1999

What do you want to change?

Add ccx to the Desktop Applications list on the community projects page (docs/guide/community-projects.md).

Why?

Disclosure: I maintain it. ccx is a free, MIT-licensed macOS menu bar app that continues a Claude Code session in Codex (and back) with its full context. It uses ccusage: when ccusage is installed, ccx runs ccusage blocks --json --token-limit max --offline (cached, at most once every 5 minutes) and, when the active block's tokenLimitStatus.status is warning or exceeds, notifies once and offers to move the task to Codex before Claude runs out. It only reads that JSON and doesn't recompute anything from the transcripts. Since max is the largest past block rather than the real limit, ccx treats it as a heads-up only.

So for ccusage users the block report turns into a next step instead of a wait for the reset.

How? (optional)

One line at the end of Desktop Applications, same format as the others. The branch is ready: https://github.com/AaronWong1999/ccusage/tree/add-ccx (title docs: add ccx to community projects). I'll open the PR once it's approved.

Activity

  1. pullfrog commented on Oct 21, 2026

    @pullfrog
    Contributor
  2. added
    documentationImprovements or additions to documentation
    priority:lowMinor polish, documentation, or a low-impact edge case.
    triage:maintainableFits the repository's maintainable scope and needs review.
    on Oct 21, 2026
  3. added
    priority:mediumA normal bug or meaningful improvement.
    and removed
    priority:lowMinor polish, documentation, or a low-impact edge case.
    on Oct 21, 2026
  4. github-actions commented on Oct 21, 2026

    @github-actions
    Contributor

    Pullfrog triage: priority:medium
    Kind: documentation
    Maintenance fit: maintainable
    Confidence: high

    Valid community projects docs request that states ccusage use and matches the contributing guide. Keep open for PR review.

    Decision: kept open.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationpriority:mediumA normal bug or meaningful improvement.triage:maintainableFits the repository's maintainable scope and needs review.

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions