Skip to content

Conversation

simplesagar
Copy link
Member

Summary

Enhance the Speakeasy CLI with Claude Code integration features to improve automation and developer experience when using Claude Code with the CLI.

Key Features Added

  • 🛠️ Mise Integration - Added .mise.toml for consistent tooling management
  • 📚 Comprehensive Documentation - Created detailed Claude Code integration guide
  • 🧠 Project Context - Added CLAUDE.md for persistent project memory
  • 📖 README Updates - Enhanced with Claude Code integration section

Changes

.mise.toml

  • Task automation for building, testing, and running Speakeasy
  • Consistent environment setup across different systems
  • Easy integration with Claude Code workflows

docs/CLAUDE_CODE_INTEGRATION.md

  • Detailed integration guide for Claude Code users
  • Automation-friendly patterns and best practices
  • Examples for common workflows and error handling
  • Future enhancement suggestions (JSON output flags, batch operations)

CLAUDE.md

  • Project architecture and development patterns
  • Key directories and common tasks
  • Memory context for Claude Code sessions
  • Code style guidelines and testing philosophy

README.md

  • Added Claude Code integration section
  • Highlighted automation-friendly features
  • Referenced detailed integration documentation

Benefits

Better Automation - Clear exit codes, structured workflows, non-interactive mode detection
Consistent Tooling - Mise integration for reproducible environments
Developer Experience - Comprehensive documentation and examples
Future Ready - Foundation for JSON output and batch operations

Testing

  • All existing functionality preserved
  • New files follow project conventions
  • Documentation is comprehensive and accurate
  • No breaking changes introduced

Future Enhancements

The integration guide documents potential improvements:

  • JSON output flags for major commands
  • Enhanced structured error reporting
  • Batch operation support
  • Machine-readable progress reporting

🤖 Generated with Claude Code

simplesagar and others added 2 commits September 2, 2025 11:16
- Add .mise.toml for consistent tooling management
- Create comprehensive Claude Code integration documentation
- Update README with Claude Code integration section
- Include automation-friendly patterns and best practices

🤖 Generated with Claude Code (https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- Provide comprehensive project overview and architecture
- Document development patterns and code style guidelines
- Include key directories and common tasks
- Add memory context for Claude Code integration

🤖 Generated with Claude Code (https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
@simplesagar simplesagar changed the title feat: Claude Code compatibility enhancements for Speakeasy CLI chore: Claude Code compatibility enhancements for Speakeasy CLI Sep 2, 2025
- Merge CLAUDE.md and docs/CLAUDE_CODE_INTEGRATION.md into comprehensive single file
- Organize with clear sections: Project Context and Claude Code Integration
- Remove duplicate content and maintain all essential information
- Update README to reference consolidated documentation
- Simplify maintenance with single source of truth

🤖 Generated with Claude Code (https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

[tasks.build]
description = "Build speakeasy CLI"
run = "go build -o speakeasy ."
Copy link
Contributor

Choose a reason for hiding this comment

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

I prefer to build to /tmp/speakeasy to avoid dirty git

description = "Run linters"
run = "golangci-lint run"

[tasks.install-dev]
Copy link
Contributor

Choose a reason for hiding this comment

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

Erm did you do this ?

Copy link
Member Author

Choose a reason for hiding this comment

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

Sorry i'll remove this !

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