Skip to content

docs: add comprehensive documentation for codeflash-cc-plugin#1857

Merged
Saga4 merged 6 commits intomainfrom
docs/cc-plugin-documentation
Mar 28, 2026
Merged

docs: add comprehensive documentation for codeflash-cc-plugin#1857
Saga4 merged 6 commits intomainfrom
docs/cc-plugin-documentation

Conversation

@aseembits93
Copy link
Copy Markdown
Contributor

Summary

  • Add 6 documentation files covering the Claude Code plugin: getting started, usage guide, configuration reference, architecture, hook lifecycle deep dive, and troubleshooting
  • Content sourced from actual plugin files (agents/optimizer.md, scripts/suggest-optimize.sh, skills/optimize/SKILL.md, commands/setup.md, hooks/hooks.json, manifests)
  • Targets both end users (getting started, usage, troubleshooting) and plugin developers (architecture, hook lifecycle)

Test plan

  • Verify markdown renders correctly on GitHub
  • Verify cross-references between docs link correctly
  • Spot-check technical details against source files in codeflash-cc-plugin

🤖 Generated with Claude Code

Six documents covering getting started, usage, configuration, architecture,
hook lifecycle, and troubleshooting for the Claude Code plugin.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@aseembits93 aseembits93 marked this pull request as draft March 17, 2026 22:54
aseembits93 and others added 3 commits March 17, 2026 15:59
Move docs into claude-code-plugin/ subdirectory as .mdx files with
Mintlify frontmatter (title, description, icon, sidebarTitle). Add
Claude Code Plugin group to docs.json navigation.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@aseembits93 aseembits93 marked this pull request as ready for review March 20, 2026 00:22
@aseembits93 aseembits93 enabled auto-merge March 20, 2026 00:22
@aseembits93 aseembits93 requested a review from Saga4 March 20, 2026 00:30
@aseembits93
Copy link
Copy Markdown
Contributor Author

there are stale files which aren't referred anywhere in the documentation

- **Claude Code** v2.1.38 or later
- **Python projects**: [codeflash](https://pypi.org/project/codeflash/) installed in a virtual environment
- **JS/TS projects**: [codeflash](https://www.npmjs.com/package/codeflash) installed as a dev dependency

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are we not supporting Java projects through this?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it didn't work super well up till now for java. we should release support for java in the future

### Add the marketplace and install

```bash
/plugin marketplace add codeflash-ai/codeflash-cc-plugin
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These need to be ran one by one
I think claude doesnt support adding cmds together for its config changes.

ANd usually copy button is given to copy the cmds together.


Or from a local clone:

```bash
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can keep this as compressed under accordian.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

removing it actually

5. It runs `codeflash --subagent` in the background with a 10-minute timeout
6. Results are reported when optimization completes

You can continue working while codeflash optimizes in the background.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does this /optimize also invokes codeflash as background task?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yes that is corrcet


I need to install and configure Codeflash for my project to enable AI-powered performance optimization.

## Objective
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@aseembits93 This was added for agents to read about codeflash fast and was based on mintlify docs.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

https://www.mintlify.com/docs/ai-native#ai-native-documentation

They might have changed now but we must have this as a support to agents to be able to install and know how to configure codeflash.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok i can restore this one, i couldn't find it referred anywhere that's why i thought it was redundant

@Saga4 Saga4 self-requested a review March 27, 2026 19:28
Copy link
Copy Markdown
Contributor

@Saga4 Saga4 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added comments

@Saga4 Saga4 disabled auto-merge March 28, 2026 06:37
@Saga4 Saga4 merged commit 73eeb86 into main Mar 28, 2026
24 of 25 checks passed
@Saga4 Saga4 deleted the docs/cc-plugin-documentation branch March 28, 2026 06:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants