@qelos/aidev 0.1.14 → 0.1.16

package/.env.aidev.example

@@ -1,3 +1,8 @@
+# AIDEV_ENV_EXTEND: path to a shared/global env file loaded as the base for this file.
+# Values in this file override the global one. Useful for sharing API keys across projects.
+# Can also be set as a shell export (e.g. in ~/.zshrc) instead.
+# AIDEV_ENV_EXTEND=~/.aidev.global
+
 # PROVIDER: clickup | jira
 PROVIDER=clickup
 

package/CONTRIBUTING.md

@@ -13,7 +13,7 @@ Thank you for your interest in contributing!
 ## Development Setup
 
 ```bash
-git clone https://github.com/your-org/aidev
+git clone https://github.com/qelos-io/aidev
 cd aidev
 npm install
 npm run dev -- init        # uses tsx, no build needed

package/README.md

@@ -102,6 +102,36 @@ aidev schedule set "*/30 * * * *"
 
 Run `aidev init` for an interactive setup, or create `.env.aidev` manually using `.env.aidev.example` as a template.
 
+### Global env file (`AIDEV_ENV_EXTEND`)
+
+If you work across multiple projects, you can keep shared settings (API keys, agent list, etc.) in a single global file and reference it from each project's `.env.aidev`:
+
+```bash
+# ~/.aidev.global
+CLICKUP_API_KEY=pk_...
+CLICKUP_TEAM_ID=123456
+AGENTS=claude,cursor
+```
+
+```bash
+# my-project/.env.aidev  — project-specific values override the global ones
+AIDEV_ENV_EXTEND=~/.aidev.global
+CLICKUP_TAG=my-project
+```
+
+**Priority order (highest → lowest):**
+
+1. Shell environment variables (e.g. set in `~/.zshrc`) — never overwritten
+2. Local `.env.aidev` values
+3. `AIDEV_ENV_EXTEND` file values (global base)
+
+`AIDEV_ENV_EXTEND` can be set in two ways:
+
+- **Per-project** — add `AIDEV_ENV_EXTEND=/path/to/file` inside `.env.aidev`
+- **Shell-wide** — `export AIDEV_ENV_EXTEND=~/.aidev.global` in `~/.zshrc` (applies to every project automatically)
+
+`aidev init` will ask for this path and pre-fill it if the variable is already in your shell environment.
+
 ### ClickUp
 
 | Variable | Default | Description |
@@ -127,6 +157,7 @@ Run `aidev init` for an interactive setup, or create `.env.aidev` manually using
 
 | Variable | Default | Description |
 |---|---|---|
+| `AIDEV_ENV_EXTEND` | — | Path to a global env file loaded as the base for this project (see above) |
 | `AGENTS` | `claude,cursor` | Comma-separated list of agents in priority order |
 | `DEV_NOTES_MODE` | `smart` | When to ask for clarification (`smart` or `always`) |
 | `AIDEV_TRIGGER_WORD` | `aidev-continue` | Comment containing this word re-triggers a skipped task |