feat: add experimental plugin / extension system

README.md

@@ -17,6 +17,19 @@ By [21st.dev](https://21st.dev) team
 - **Integrated Terminal** - Full terminal access within the app
 - **Change Tracking** - Visual diffs and PR management
 
+## 🔌 Plugin System (Experimental)
+
+1Code includes an experimental plugin architecture that allows extending functionality
+without modifying core code.
+
+Plugins can:
+- Register custom commands
+- Hook into application lifecycle
+- Enable future extensions like linters, formatters, and AI tools
+
+See `src/shared/plugins/samplePlugin.ts` for a minimal example.
+
+
 ## Installation
 
 ### Option 1: Build from source (free)
@@ -45,6 +58,32 @@ bun run claude:download  # First time only
 bun run dev
 ```
 
+## Codespaces & Linux Notes
+
+When running the Electron app inside **GitHub Codespaces**, Docker containers,
+or minimal Linux environments, the UI may fail to launch due to the absence of
+an X11 display server.
+
+This is expected behavior and does **not** block development or builds.
+
+If you encounter dependency resolution issues, use:
+
+```bash
+npm install --legacy-peer-deps
+```
+
+On Linux, Electron may require additional system libraries:
+
+```bash
+sudo apt-get install -y libatk1.0-0 libgtk-3-0 libnss3 libxss1 libasound2
+```
+
+You can still validate your changes by running:
+
+```bash
+npm run build
+```
+
 ## Feedback & Community
 
 Join our [Discord](https://discord.gg/8ektTZGnj4) for support and discussions.