71 lines
1.9 KiB
Markdown
71 lines
1.9 KiB
Markdown
# Contributing
|
|
|
|
Thank you for your interest in contributing to the OpenCode Obsidian plugin!
|
|
|
|
## What We Accept
|
|
|
|
We welcome the following types of contributions:
|
|
|
|
- Windows and WSL support
|
|
- Documentation improvements
|
|
- Bug fixes
|
|
|
|
**Note:** Core product features and major changes require prior discussion. Please [open an issue](https://github.com/mtymek/opencode-obsidian/issues) first to discuss your proposal before starting work. PRs for new features submitted without prior approval may be closed.
|
|
|
|
I'm also interested in collecting a set of Agent Skills useful in the context of Obsidian vaults. Feel free to submit an issue or PR with your ideas.
|
|
|
|
## Development Setup
|
|
|
|
### Requirements
|
|
|
|
- [Bun](https://bun.sh/) 1.3+
|
|
- Obsidian (for testing the plugin)
|
|
|
|
### Getting Started
|
|
|
|
```bash
|
|
git clone https://github.com/mtymek/opencode-obsidian.git
|
|
cd opencode-obsidian
|
|
bun install
|
|
```
|
|
|
|
### Development Workflow
|
|
|
|
To work on the plugin during development:
|
|
|
|
1. Build the plugin:
|
|
```bash
|
|
bun run build # One-time production build
|
|
```
|
|
|
|
2. The plugin will be built to `main.js` in the project root
|
|
|
|
3. For testing in Obsidian:
|
|
- Enable Community Plugins in Obsidian settings
|
|
- Copy the built plugin to your vault's `.obsidian/plugins/opencode-obsidian/` directory
|
|
- Reload Obsidian or use the "Reload app without saving" command
|
|
|
|
### Commands
|
|
|
|
```bash
|
|
bun install # Install dependencies
|
|
bun run build # Production build with type checking
|
|
bun test # Run tests
|
|
```
|
|
|
|
## Before Submitting a PR
|
|
|
|
1. Run `bun run build` to ensure type checking passes
|
|
2. Run `bun test` to ensure all tests pass
|
|
3. Test the plugin in Obsidian to verify functionality
|
|
|
|
## Pull Requests
|
|
|
|
1. Keep PRs small and focused on a single concern
|
|
2. Explain what your PR is attempting to fix or improve
|
|
3. Link any relevant issues in the PR description
|
|
|
|
## License
|
|
|
|
By contributing to the OpenCode Obsidian plugin, you agree to license your contribution under the [MIT License](LICENSE).
|