Skip to content

Feature/pypi release#36

Merged
simonweigold merged 23 commits into
mainfrom
feature/pypi-release
May 3, 2026
Merged

Feature/pypi release#36
simonweigold merged 23 commits into
mainfrom
feature/pypi-release

Conversation

@simonweigold

Copy link
Copy Markdown
Owner

This pull request significantly expands and clarifies the documentation for using and developing with the openclerk reasoning kit system. It introduces new CLI workflows, details on dynamic resources, tool and MCP server integration, and updates to the release process and automation scripts. The changes aim to make it easier for users to understand best practices, leverage new features, and use the CLI as the primary interface for all operations.

Documentation and CLI Workflow Enhancements:

  • Overhauled SKILL.md and AGENTS.md to emphasize using the CLI (openclerk) for all kit operations, including running, validating, and managing reasoning kits. Added detailed sections on dynamic resources, tool integration via tool_*.json, and MCP server configuration (kit-local and project-root mcp_servers.json). Provided new CLI usage examples and discouraged custom Python scripts for standard workflows. [1] [2] [3] [4] [5] [6] [7] [8] [9]

  • Added comprehensive documentation for tool references and tool execution logging, including how to define tools in tool_*.json and how logs are emitted during execution. [1] [2] [3]

  • Clarified and documented the structure and merging behavior of MCP server configs, with example JSON and explanation of supported transports (stdio, sse, http). [1] [2] [3]

Automation and Release Process:

  • Added a new .github/workflows/release.yml workflow to automate package building and publishing to PyPI on tagged releases.

  • Updated CI workflows to use the latest astral-sh/setup-uv@v4 action for improved reliability and compatibility. [1] [2]

Developer Tooling and Scripts:

  • Enhanced the Justfile with new commands for documentation sync, building and publishing packages, and version management to streamline development and release tasks.

Other Improvements:

  • Updated version numbers and improved formatting in documentation tables for clarity and accuracy. [1] [2] [3]

These changes collectively improve usability, maintainability, and extensibility for both end-users and developers working with reasoning kits and the openclerk system.

Checklist

  • Tests pass (just test)
  • Code follows style (just lint)
  • Documentation updated (if needed)
  • Related issue linked

Additional Notes

Clerk is now ready to be published as a python package on PyPI.

simonweigold and others added 23 commits April 20, 2026 17:43
- Created overview and running kits documentation in the web UI.
- Added a comprehensive user guide covering installation, workflows, and common commands.
- Introduced core concepts documentation detailing reasoning kits, resources, instructions, and workflows.
- Developed an FAQ section addressing common installation and usage questions.
- Implemented a new DocsPage component for rendering documentation with navigation.
- Integrated documentation syncing script to keep website docs updated.
- Updated App and Layout components to include documentation links in the navigation.
- Adjusted project metadata to reflect the correct repository links.
…iple kit-local config paths and improve prompt handling in API routes.
…bels and improve user guidance for optional inputs.
- Changed the default model from gpt-5-mini to gpt-5.4-nano in graph.py and llm_factory.py.
- Updated the fallback model for provider configuration to gpt-5.4-nano.
- Modified the resource size threshold in resolve_placeholders function from 4000 to 400000.
- Updated test_mcp_integration.py to use the new default model in the run_reasoning_kit function.
…ment output saving functionality for run results
@vercel

vercel Bot commented May 3, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
clerk Ready Ready Preview, Comment May 3, 2026 3:47pm

@simonweigold simonweigold merged commit b327d7e into main May 3, 2026
5 checks passed
@simonweigold simonweigold deleted the feature/pypi-release branch May 3, 2026 15:48
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.

1 participant