Bikeshed, a place to sweat the details, however trivial.
BikeShed is an experimental project built as a Model Context Protocol (MCP) client. There are many like it, this is mine.
This project aims to provide a flexible playground creating reusable context sets: instructions, tools, resources. The main goal is to be able to experiment with simple workflows to create artifacts. Eventually, a goal it to generate a detailed specification for a workflow that can be "compiled" into a executable application.
- Experimental: BikeShed serves as a playground for developers interested in experimenting with MCP-related concepts.
- Declarative Workflow Syntax: Trying to make building simple workflow components using YAML easy
- Context Management: Tools for managing and manipulating model contexts.
To get started with BikeShed, follow these steps:
- Clone the repository:
git clone https://github.com/wesnick/bikeshed.git
cd bikeshed- Install dependencies:
You need uv, rust, go, npm, deno installed. Sorry, this is a developer app so these are table stakes.
OS dependencies, assuming Debian-flavored distro
sudo apt-get install libmagic1 graphviz graphviz-devPython
uv syncRust
cargo install just
cargo install monolithGolang
go install github.com/stripe/pg-schema-diff/cmd/pg-schema-diff@latestNode
npm installDeno
curl -fsSL https://deno.land/install.sh | sh- Run the project:
From here on out, use just
just setup-env # be sure to edit your .env
just docup
# Dev has 3 processes
just fastapi-dev
just frontend-dev
just arq-devMake sure to check the [docs/project.md] for additional info.
TBD
We appreciate contributions to BikeShed! If you're interested in contributing, please fork the repository and submit a pull request. You can also report issues or propose features through the GitHub issues page.
- Fork it (https://github.com/wesnick/bikeshed/fork)
- Create your feature branch (
git checkout -b feature/MyNewFeature) - Commit your changes (
git commit -m 'Add some feature') - Push to the branch (
git push origin feature/MyNewFeature) - Create a new Pull Request
BikeShed is licensed under the MIT License. See the LICENSE file for more information.
For questions, feedback, or inquiries about BikeShed, please reach out:
- GitHub Issues: https://github.com/wesnick/bikeshed/issues
Disclaimer: BikeShed is an experimental project and may contain bugs or unfinished features. It is intended for exploration and should be used with caution in production environments.