Feature: Add Workflow Status Updates

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

.github/ISSUE_TEMPLATE/issues.md

@@ -0,0 +1,24 @@
+---
+name: Issues
+about: Issues template
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe your issue**
+A clear and concise description of what the issue is and what error messages you are seeing.
+
+**MCP Config**
+Please share your MCP config (but make sure to not include your Shortcut API token)
+
+**Environment (please complete the following information):**
+ - OS: [e.g. Windows, Mac, Linux]
+ - IDE: [e.g. Cursor, Windsurf]
+ - IDE Version [e.g. 1.5.9]
+ - Node version [e.g. v22.14.0]
+ - Node version manager [e.g. Nvm, Asdf, Mise]
+
+**Additional context**
+Add any other context about the problem here.

.github/workflows/pr_actions.yml

@@ -0,0 +1,49 @@
+name: PR Checks
+env:
+  HUSKY: 0
+
+on:
+  workflow_dispatch:
+  pull_request:
+
+jobs:
+  pr-checks:
+    strategy:
+      fail-fast: true
+
+    permissions:
+      contents: read
+
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+      - uses: biomejs/setup-biome@v2
+        with:
+          version: latest
+
+      - name: Install dependencies
+        working-directory: ./
+        run: |
+          npm ci
+
+      - name: Run linter
+        working-directory: ./
+        run: |
+          biome ci .
+
+      - name: Run type checker
+        working-directory: ./
+        run: |
+          npm run ts
+
+      - name: Run tests
+        working-directory: ./
+        run: |
+          npm run test
+
+      - name: Build
+        working-directory: ./
+        run: |
+          npm run build

.husky/pre-commit

@@ -1,2 +1,2 @@
 npm run format
-git add .
+git add -u .

README.md

@@ -51,16 +51,95 @@ See the [official Cursor docs](https://docs.cursor.com/context/model-context-pro
 }
 ```
 
+### Claude Code
+
+See the [official Claude Code docs](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/tutorials#set-up-model-context-protocol-mcp) for more information.
+
+_You can add a new MCP server from the Claude Code CLI. But modifying the json file directly is simpler!_
+
+1. Open the Claude Code configuration file (it should be in `~/.claude.json`).
+2. Find the `projects` > `mcpServers` section and add the following details and save the file:
+
+```json
+{
+  "projects": {
+    "mcpServers": {
+      "shortcut": {
+        "command": "npx",
+        "args": [
+          "-y",
+          "@shortcut/mcp"
+        ],
+        "env": {
+          "SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
+        }
+      }
+    }
+  }
+}
+```
+
+## Issues and Troubleshooting
+
+Before doing anything else, please make sure you are running the latest version!
+
+If you run into problems using this MCP server, you have a couple of options:
+
+- Open an issue on [GitHub](https://github.com/useshortcut/mcp-server-shortcut/issues)
+- Ask for help in the community [Slack](https://shortcut.com/join-slack)
+
+You can also check the list of [common issues](#common-issues) below to see if there is a known solution already.
+
+### Common Issues and Solutions
+
+#### NPX command not working when using MISE for version management
+
+If you are using MISE for managing Node and NPM versions, you may encounter a "Client closed" error when trying to run the MCP server. Installing this extension into your IDE might help: https://github.com/hverlin/mise-vscode/.
+
 ## Development
 
-## Installation
+### Installation
 
 ```bash
 npm install
 ```
 
-## Build
+### Build
 
 ```bash
 npm run build
-```
+```
+
+### Running the Development Server Locally
+
+To test your local development version of the MCP server rather than using the published package, follow these steps:
+
+1. Build the project:
+   ```bash
+   npm run build
+   ```
+
+2. Create or modify your `mcp.json` file to reference your local build:
+   ```json
+   {
+     "mcpServers": {
+       "shortcut": {
+         "command": "node",
+         "args": [
+           "/path/to/your/local/mcp-server-shortcut/dist/index.js"
+         ],
+         "env": {
+           "SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
+         }
+       }
+     }
+   }
+   ```
+
+3. Place this `mcp.json` file in one of the following locations:
+   - For Cursor: In your home directory (`~/.cursor/mcp.json`) or in your project directory (`.cursor/mcp.json`)
+   - For Windsurf: Use the MCP Configuration Panel to add the custom server
+
+4. Restart your AI assistant (Cursor or Windsurf) to load the new configuration.
+
+This allows you to instantly test changes to the MCP server without having to publish a new version.

biome.json

@@ -7,7 +7,7 @@
 	},
 	"files": {
 		"ignoreUnknown": false,
-		"ignore": ["node_modules/**"]
+		"include": ["src/**", "index.ts"]
 	},
 	"formatter": {
 		"enabled": true,