Releases: cordfuse/cortex
Release list
Cortex v4.9.1
Cortex v4.9.1
How to install
Mac or Linux
Open Terminal. Paste this. Hit Enter.
curl -fsSL https://github.com/cordfuse/cortex/releases/latest/download/install.sh | bashIt will ask you two things:
- Your repo URL (the GitHub repo you created from the Cortex template)
- Where to put it on your computer (just hit Enter to use the default)
That's it.
Windows
Open PowerShell. Paste this. Hit Enter.
iex (irm https://github.com/cordfuse/cortex/releases/latest/download/install.ps1)Same two questions. Same deal.
Don't have a repo yet?
- Go to https://github.com/cordfuse/cortex
- Click the green "Use this template" button → "Create a new repository"
- Give it a name (e.g.
cortex), set it to Private, click Create repository - Copy your new repo's URL
- Run the installer above and paste the URL when it asks
Already set up on another machine?
Run the same installer. When it asks for your repo URL, give it the same one.
It will clone your existing records and repair your environment.
Nothing gets overwritten.
What the installer does
- Checks what's installed on your machine (git, Python, etc.)
- Installs anything that's missing
- Asks for your repo URL and where to clone it
- Warns you if your repo is public (it should be private)
- Clones your repo
- Installs all Cortex dependencies
When it's done: open the folder in your AI agent (Claude, ChatGPT, etc.) and say hello.
Cortex v4.9.0
Cortex v4.9.0
How to install
Mac or Linux
Open Terminal. Paste this. Hit Enter.
curl -fsSL https://github.com/cordfuse/cortex/releases/latest/download/install.sh | bashIt will ask you two things:
- Your repo URL (the GitHub repo you created from the Cortex template)
- Where to put it on your computer (just hit Enter to use the default)
That's it.
Windows
Open PowerShell. Paste this. Hit Enter.
iex (irm https://github.com/cordfuse/cortex/releases/latest/download/install.ps1)Same two questions. Same deal.
Don't have a repo yet?
- Go to https://github.com/cordfuse/cortex
- Click the green "Use this template" button → "Create a new repository"
- Give it a name (e.g.
cortex), set it to Private, click Create repository - Copy your new repo's URL
- Run the installer above and paste the URL when it asks
Already set up on another machine?
Run the same installer. When it asks for your repo URL, give it the same one.
It will clone your existing records and repair your environment.
Nothing gets overwritten.
What the installer does
- Checks what's installed on your machine (git, Python, etc.)
- Installs anything that's missing
- Asks for your repo URL and where to clone it
- Warns you if your repo is public (it should be private)
- Clones your repo
- Installs all Cortex dependencies
When it's done: open the folder in your AI agent (Claude, ChatGPT, etc.) and say hello.
Cortex v4.7.0
Cortex v4.7.0
How to install
Mac or Linux
Open Terminal. Paste this. Hit Enter.
curl -fsSL https://github.com/cordfuse/cortex/releases/latest/download/install.sh | bashIt will ask you two things:
- Your repo URL (the GitHub repo you created from the Cortex template)
- Where to put it on your computer (just hit Enter to use the default)
That's it.
Windows
Open PowerShell. Paste this. Hit Enter.
iex (irm https://github.com/cordfuse/cortex/releases/latest/download/install.ps1)Same two questions. Same deal.
Don't have a repo yet?
- Go to https://github.com/cordfuse/cortex
- Click the green "Use this template" button → "Create a new repository"
- Give it a name (e.g.
cortex), set it to Private, click Create repository - Copy your new repo's URL
- Run the installer above and paste the URL when it asks
Already set up on another machine?
Run the same installer. When it asks for your repo URL, give it the same one.
It will clone your existing records and repair your environment.
Nothing gets overwritten.
What the installer does
- Checks what's installed on your machine (git, Python, etc.)
- Installs anything that's missing
- Asks for your repo URL and where to clone it
- Warns you if your repo is public (it should be private)
- Clones your repo
- Installs all Cortex dependencies
When it's done: open the folder in your AI agent (Claude, ChatGPT, etc.) and say hello.
Cortex v4.7.0
Cortex v4.7.0
How to install
Mac or Linux
Open Terminal. Paste this. Hit Enter.
curl -fsSL https://github.com/cordfuse/cortex/releases/latest/download/install.sh | bashIt will ask you two things:
- Your repo URL (the GitHub repo you created from the Cortex template)
- Where to put it on your computer (just hit Enter to use the default)
That's it.
Windows
Open PowerShell. Paste this. Hit Enter.
iex (irm https://github.com/cordfuse/cortex/releases/latest/download/install.ps1)Same two questions. Same deal.
Don't have a repo yet?
- Go to https://github.com/cordfuse/cortex
- Click the green "Use this template" button → "Create a new repository"
- Give it a name (e.g.
cortex), set it to Private, click Create repository - Copy your new repo's URL
- Run the installer above and paste the URL when it asks
Already set up on another machine?
Run the same installer. When it asks for your repo URL, give it the same one.
It will clone your existing records and repair your environment.
Nothing gets overwritten.
What the installer does
- Checks what's installed on your machine (git, Python, etc.)
- Installs anything that's missing
- Asks for your repo URL and where to clone it
- Warns you if your repo is public (it should be private)
- Clones your repo
- Installs all Cortex dependencies
When it's done: open the folder in your AI agent (Claude, ChatGPT, etc.) and say hello.
Cortex v4.6.6
Cortex v4.6.6
How to install
Mac or Linux
Open Terminal. Paste this. Hit Enter.
curl -fsSL https://github.com/cordfuse/cortex/releases/latest/download/install.sh | bashIt will ask you two things:
- Your repo URL (the GitHub repo you created from the Cortex template)
- Where to put it on your computer (just hit Enter to use the default)
That's it.
Windows
Open PowerShell. Paste this. Hit Enter.
iex (irm https://github.com/cordfuse/cortex/releases/latest/download/install.ps1)Same two questions. Same deal.
Don't have a repo yet?
- Go to https://github.com/cordfuse/cortex
- Click the green "Use this template" button → "Create a new repository"
- Give it a name (e.g.
cortex), set it to Private, click Create repository - Copy your new repo's URL
- Run the installer above and paste the URL when it asks
Already set up on another machine?
Run the same installer. When it asks for your repo URL, give it the same one.
It will clone your existing records and repair your environment.
Nothing gets overwritten.
What the installer does
- Checks what's installed on your machine (git, Python, etc.)
- Installs anything that's missing
- Asks for your repo URL and where to clone it
- Warns you if your repo is public (it should be private)
- Clones your repo
- Installs all Cortex dependencies
When it's done: open the folder in your AI agent (Claude, ChatGPT, etc.) and say hello.
Cortex v4.6.5
Cortex v4.6.5
How to install
Mac or Linux
Open Terminal. Paste this. Hit Enter.
curl -fsSL https://github.com/cordfuse/cortex/releases/latest/download/install.sh | bashIt will ask you two things:
- Your repo URL (the GitHub repo you created from the Cortex template)
- Where to put it on your computer (just hit Enter to use the default)
That's it.
Windows
Open PowerShell. Paste this. Hit Enter.
iex (irm https://github.com/cordfuse/cortex/releases/latest/download/install.ps1)Same two questions. Same deal.
Don't have a repo yet?
- Go to https://github.com/cordfuse/cortex
- Click the green "Use this template" button → "Create a new repository"
- Give it a name (e.g.
cortex), set it to Private, click Create repository - Copy your new repo's URL
- Run the installer above and paste the URL when it asks
Already set up on another machine?
Run the same installer. When it asks for your repo URL, give it the same one.
It will clone your existing records and repair your environment.
Nothing gets overwritten.
What the installer does
- Checks what's installed on your machine (git, Python, etc.)
- Installs anything that's missing
- Asks for your repo URL and where to clone it
- Warns you if your repo is public (it should be private)
- Clones your repo
- Installs all Cortex dependencies
When it's done: open the folder in your AI agent (Claude, ChatGPT, etc.) and say hello.
Cortex v4.6.4
Cortex v4.6.4
How to install
Mac or Linux
Open Terminal. Paste this. Hit Enter.
curl -fsSL https://github.com/cordfuse/cortex/releases/latest/download/install.sh | bashIt will ask you two things:
- Your repo URL (the GitHub repo you created from the Cortex template)
- Where to put it on your computer (just hit Enter to use the default)
That's it.
Windows
Open PowerShell. Paste this. Hit Enter.
iex (irm https://github.com/cordfuse/cortex/releases/latest/download/install.ps1)Same two questions. Same deal.
Don't have a repo yet?
- Go to https://github.com/cordfuse/cortex
- Click the green "Use this template" button → "Create a new repository"
- Give it a name (e.g.
cortex), set it to Private, click Create repository - Copy your new repo's URL
- Run the installer above and paste the URL when it asks
Already set up on another machine?
Run the same installer. When it asks for your repo URL, give it the same one.
It will clone your existing records and repair your environment.
Nothing gets overwritten.
What the installer does
- Checks what's installed on your machine (git, Python, etc.)
- Installs anything that's missing
- Asks for your repo URL and where to clone it
- Warns you if your repo is public (it should be private)
- Clones your repo
- Installs all Cortex dependencies
When it's done: open the folder in your AI agent (Claude, ChatGPT, etc.) and say hello.
Cortex v4.2.1
Cortex v4.2.1
How to install
Mac or Linux
Open Terminal. Paste this. Hit Enter.
curl -fsSL https://github.com/cordfuse/cortex/releases/latest/download/install.sh | bashIt will ask you two things:
- Your repo URL (the GitHub repo you created from the Cortex template)
- Where to put it on your computer (just hit Enter to use the default)
That's it.
Windows
Open PowerShell. Paste this. Hit Enter.
iex (irm https://github.com/cordfuse/cortex/releases/latest/download/install.ps1)Same two questions. Same deal.
Don't have a repo yet?
- Go to https://github.com/cordfuse/cortex
- Click the green "Use this template" button → "Create a new repository"
- Give it a name (e.g.
cortex), set it to Private, click Create repository - Copy your new repo's URL
- Run the installer above and paste the URL when it asks
Already set up on another machine?
Run the same installer. When it asks for your repo URL, give it the same one.
It will clone your existing records and repair your environment.
Nothing gets overwritten.
What the installer does
- Checks what's installed on your machine (git, Python, etc.)
- Installs anything that's missing
- Asks for your repo URL and where to clone it
- Warns you if your repo is public (it should be private)
- Clones your repo
- Installs all Cortex dependencies
When it's done: open the folder in your AI agent (Claude, ChatGPT, etc.) and say hello.
Cortex v4.1.1 — google.py inline re-auth-and-retry
Cortex v4.1.1 — google.py inline re-auth-and-retry
Quality-of-life patch on v4.1.0. The write commands (send-mail, create-event, create-task) now detect missing scopes, prompt the user to re-authorize inline, and retry the original call automatically. No more manual two-step.
Before (v4.1.0)
```bash
python scripts/integrations/google.py send-mail --to ... # 403, gives up
python scripts/integrations/google.py auth # manual re-auth
python scripts/integrations/google.py send-mail --to ... # finally works
```
After (v4.1.1+)
```bash
$ python scripts/integrations/google.py send-mail --to ...
Cortex's gmail connector needs a scope your current OAuth grant doesn't have.
(This happens after upgrading from a read-only cortex; 'send' was added in v4.1.0+.)
Re-authorize now to upgrade the grant? [y/N]: y
Running auth flow — your browser will open. Approve the new scope list to continue.
[browser opens, user approves]
Re-auth complete. Retrying send...
Sent. Gmail message ID: 196f3a8b...
To: alice@example.com
Subject: Hello
```
One command, one prompt, one browser approve, done.
Non-interactive contexts (cron, headless, sandboxed)
Falls through to the v4.1.0 fail-clean path. No prompt, no hang. Prints "re-run auth" + exits non-zero. Per ROE Rule 19: never block waiting for input that won't come.
Migration
Nothing required. Existing v4.1.0 users get the inline re-auth UX automatically on next sync. The first write command after upgrade triggers the prompt; subsequent commands use the new (broader-scoped) refresh token directly.
How to install
Mac or Linux
```bash
curl -fsSL https://github.com/cordfuse/cortex/releases/latest/download/install.sh | bash
```
Windows
```powershell
iex (irm https://github.com/cordfuse/cortex/releases/latest/download/install.ps1)
```
Cortex v4.1.0 — google.py write capabilities
Cortex v4.1.0 — google.py write capabilities
The cortex Google connector goes from observation-only to action-capable. Read commands unchanged; new write surface mirrors and exceeds the Anthropic MCP for shared services.
What's new
New write subcommands
```bash
python scripts/integrations/google.py send-mail --to --subject --body
python scripts/integrations/google.py create-event --summary --start --end [--calendar primary] [--description ] [--location ] [--attendees a@b,c@d]
python scripts/integrations/google.py create-task --title [--list @default] [--notes ] [--due ]
```
Expanded SCOPES
| Service | Before (4.0.x) | Now (4.1.0+) |
|---|---|---|
| Calendar | calendar.readonly | + calendar.events (RW events on existing calendars) |
| Gmail | gmail.readonly | gmail.modify (read+label+draft) + gmail.send |
| Drive | drive.readonly | + drive.file (least-privilege RW for cortex's own files) |
| Tasks | tasks.readonly | tasks (full RW) |
| Contacts | contacts.readonly | contacts (full RW) |
ROE Rule 19 compliance
New `_handle_api_error` helper catches all HttpError + network errors and translates them to plain-English fallback messages with concrete next-action guidance. No stack traces.
- 401 (auth expired) → "re-run auth"
- 403 (insufficient_scope) → "re-run auth to upgrade the grant"
- 429 (rate-limited) → "try again in a few minutes"
- 5xx → "Google-side issue, try later"
- TLS/SSL/connection → "unreachable from this environment"
Migration for existing users
```bash
1. Sync to v4.1.0
sync # or 'git pull' if you don't run sync
2. Re-auth to upgrade the OAuth grant
python scripts/integrations/google.py auth --passphrase
Browser opens; new scope list shown; approve; new refresh token
saved to vault, overwriting the old read-only token.
3. Write commands now work
python scripts/integrations/google.py send-mail --to ...
```
Read commands keep working with the old read-only token through this transition. Write commands return a 403 with a "re-run auth" hint until you re-auth.
Why this matters
Cortex's connector strategy was originally observation-only. The Anthropic MCP filled the action gap (drafting mail, creating events). With v4.1.0, cortex's own connectors handle action too — and uniquely cover Google Tasks and Contacts which the MCP doesn't surface. The architectural distinction the prior backlog noted ("cortex for audit, MCP for action") collapses: cortex now does both, and adds Tasks + Contacts on top.
How to install
Mac or Linux
```bash
curl -fsSL https://github.com/cordfuse/cortex/releases/latest/download/install.sh | bash
```
Windows
```powershell
iex (irm https://github.com/cordfuse/cortex/releases/latest/download/install.ps1)
```
