Skip to content

Commit 10124d2

Browse files
KD-K2N2claude
KD-K2N2
and
claude
committed
Initial release — Cortex v1.0.0
Persistent memory layer for Claude Code. Every session starts fully informed. 9 packages: - @cortex/server: MCP server, REST API, SQLite, quality gate, sync, summarizer - @cortex/cli: 30+ commands for memory management - @cortex/shared: types, schemas, constants, utilities - @cortex/dashboard: Next.js web UI (11 views) - @cortex/desktop: Native SwiftUI Mac app - @cortex/electron: Cross-platform desktop wrapper - @cortex/vscode: VS Code extension - @cortex/installer: brew, npx, curl install methods - @cortex/web: cortex.sh landing + subscriber verification Security: AES-256-GCM credential encryption, Zod validation, rate limiting, SQL injection protection, quality gate with sensitive data scanner. 85+ tests across 15 test files. 7 documentation pages. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
0 parents  commit 10124d2

216 files changed

Lines changed: 32049 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.env.example‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
# Cortex Configuration
2+
CORTEX_PORT=7434
3+
CORTEX_DB_PATH=~/.cortex/memory.db
4+
CORTEX_LOG_LEVEL=info
5+
6+
# Session Summarizer (optional)
7+
ANTHROPIC_API_KEY=
8+
OPENAI_API_KEY=
9+
10+
# Turso Sync (optional)
11+
TURSO_DATABASE_URL=
12+
TURSO_AUTH_TOKEN=

‎.eslintrc.json‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
{
2+
"root": true,
3+
"parser": "@typescript-eslint/parser",
4+
"plugins": ["@typescript-eslint"],
5+
"extends": [
6+
"eslint:recommended",
7+
"plugin:@typescript-eslint/recommended"
8+
],
9+
"rules": {
10+
"@typescript-eslint/no-explicit-any": "warn",
11+
"@typescript-eslint/explicit-function-return-type": ["warn", { "allowExpressions": true }],
12+
"@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
13+
"no-console": ["warn", { "allow": ["warn", "error"] }],
14+
"prefer-const": "error",
15+
"no-var": "error",
16+
"eqeqeq": ["error", "always"]
17+
},
18+
"ignorePatterns": ["dist/", "node_modules/", ".next/", "*.js"]
19+
}

‎.github/CODEOWNERS‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# Default owner for everything
2+
* @koundinyalanka
3+
4+
# Package-specific ownership
5+
packages/server/ @koundinyalanka
6+
packages/cli/ @koundinyalanka
7+
packages/dashboard/ @koundinyalanka
8+
packages/web/ @koundinyalanka
9+
packages/desktop/ @koundinyalanka
10+
packages/vscode/ @koundinyalanka
11+
packages/shared/ @koundinyalanka
12+
packages/installer/ @koundinyalanka
13+
packages/electron/ @koundinyalanka

‎.github/DISCUSSION_TEMPLATE/ideas.yml‎

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
title: "Ideas & Feature Brainstorming"
2+
labels:
3+
- idea
4+
- discussion
5+
body:
6+
- type: markdown
7+
attributes:
8+
value: |
9+
**Got an idea for Cortex?** We'd love to hear it.
10+
11+
Whether it's a new feature, an integration, or a workflow improvement — share your thoughts and let the community weigh in.
12+
13+
- type: textarea
14+
id: idea
15+
attributes:
16+
label: "The Idea"
17+
description: "Describe your idea in a few sentences."
18+
placeholder: "What if Cortex could..."
19+
validations:
20+
required: true
21+
22+
- type: textarea
23+
id: problem
24+
attributes:
25+
label: "What problem does this solve?"
26+
description: "What pain point or gap does this address?"
27+
placeholder: "Currently, when I work with Claude Code, I have to..."
28+
validations:
29+
required: true
30+
31+
- type: dropdown
32+
id: scope
33+
attributes:
34+
label: "Scope"
35+
description: "How big is this idea?"
36+
options:
37+
- "Small tweak (CLI flag, config option)"
38+
- "Medium feature (new command, dashboard widget)"
39+
- "Large feature (new package, major integration)"
40+
- "Architectural change"
41+
validations:
42+
required: true
43+
44+
- type: textarea
45+
id: prior-art
46+
attributes:
47+
label: "Prior Art / Inspiration"
48+
description: "Have you seen this done well elsewhere? Links welcome."
49+
placeholder: "I saw something similar in..."
50+
51+
- type: checkboxes
52+
id: contribution
53+
attributes:
54+
label: "Would you help build this?"
55+
options:
56+
- label: "I'd be willing to submit a PR for this"
57+
- label: "I can help test or provide feedback"
58+
- label: "I'm sharing the idea for others to pick up"

‎.github/FUNDING.yml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
github: [ProductionLineHQ]
2+
custom: ["https://ProductionLineHQ.ai"]

‎.github/ISSUE_TEMPLATE/bug_report.md‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
---
2+
name: "\U0001F41B Bug Report"
3+
about: Something isn't working as expected
4+
title: '[Bug] '
5+
labels: bug
6+
assignees: ''
7+
---
8+
9+
## Describe the bug
10+
11+
A clear description of what the bug is.
12+
13+
## To Reproduce
14+
15+
1. Run '...'
16+
2. Configure '...'
17+
3. See error...
18+
19+
## Expected behavior
20+
21+
What you expected to happen.
22+
23+
## Environment
24+
25+
- **OS**: [e.g., macOS 14.2, Ubuntu 24.04]
26+
- **Node**: [e.g., 22.12.0]
27+
- **Cortex version**: [e.g., 1.0.0]
28+
- **Claude Code version**: [e.g., 1.x.x]
29+
- **Install method**: [brew / npm / source]
30+
31+
## Logs
32+
33+
```
34+
Paste output of `cortex doctor --verbose`
35+
```
36+
37+
## Screenshots
38+
39+
If applicable, add screenshots to help explain your problem.
40+
41+
## Additional context
42+
43+
Any other context about the problem here.

‎.github/ISSUE_TEMPLATE/feature_request.md‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
name: "\U0001F4A1 Feature Request"
3+
about: Suggest an idea for Cortex
4+
title: '[Feature] '
5+
labels: enhancement
6+
assignees: ''
7+
---
8+
9+
## Problem
10+
11+
A clear description of what the problem is.
12+
13+
*Example: "I'm always frustrated when Claude forgets my project conventions between sessions..."*
14+
15+
## Proposed Solution
16+
17+
A clear description of what you'd like to happen.
18+
19+
## Alternatives Considered
20+
21+
Describe any alternative solutions or features you've considered.
22+
23+
## Use Case
24+
25+
Who would benefit from this feature and how?
26+
27+
- **User type**: [solo dev / team / enterprise]
28+
- **Frequency**: [daily / weekly / occasionally]
29+
- **Impact**: [nice-to-have / important / critical]
30+
31+
## Additional Context
32+
33+
Add any mockups, screenshots, or references here.

‎.github/PULL_REQUEST_TEMPLATE.md‎

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
## Summary
2+
3+
Brief description of the changes and the motivation behind them.
4+
5+
Fixes # (issue number)
6+
7+
## Type of Change
8+
9+
- [ ] Bug fix (non-breaking change that fixes an issue)
10+
- [ ] New feature (non-breaking change that adds functionality)
11+
- [ ] Breaking change (fix or feature that would cause existing functionality to change)
12+
- [ ] Documentation update
13+
- [ ] Performance improvement
14+
- [ ] Refactoring (no functional changes)
15+
16+
## How Has This Been Tested?
17+
18+
Describe the tests you ran to verify your changes.
19+
20+
- [ ] Unit tests pass (`pnpm test`)
21+
- [ ] Lint passes (`pnpm lint`)
22+
- [ ] Type check passes (`pnpm typecheck`)
23+
- [ ] Manual testing with Claude Code
24+
25+
## Checklist
26+
27+
- [ ] My code follows the project's style guidelines
28+
- [ ] I have performed a self-review of my code
29+
- [ ] I have added tests that prove my fix is effective or my feature works
30+
- [ ] New and existing unit tests pass locally with my changes
31+
- [ ] I have updated documentation where needed
32+
- [ ] My changes generate no new warnings
33+
- [ ] Any dependent changes have been merged and published
34+
35+
## Screenshots (if applicable)
36+
37+
Add screenshots for UI changes in the dashboard or VS Code extension.

‎.github/README.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# Cortex
2+
3+
**We build developer tools that make AI assistants smarter.**
4+
5+
Cortex is a persistent memory layer for Claude Code — giving your AI assistant long-term recall across sessions, projects, and machines.
6+
7+
- [Cortex](https://github.com/ProductionLineHQ/cortex) — The core memory engine
8+
- [Website](https://ProductionLineHQ.ai) — Learn more
9+
- [Documentation](https://github.com/ProductionLineHQ/cortex#readme) — Get started
10+
11+
---
12+
13+
Built by [K2N2 Studio](https://k2n2studio.com). MIT Licensed.

‎.github/workflows/ci.yml‎

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
name: CI
2+
3+
on:
4+
push:
5+
branches: [main]
6+
pull_request:
7+
branches: [main]
8+
9+
jobs:
10+
lint-and-typecheck:
11+
runs-on: ubuntu-latest
12+
steps:
13+
- uses: actions/checkout@v4
14+
- uses: pnpm/action-setup@v3
15+
with:
16+
version: 10
17+
- uses: actions/setup-node@v4
18+
with:
19+
node-version: 22
20+
cache: pnpm
21+
- run: pnpm install --frozen-lockfile
22+
- run: pnpm turbo lint
23+
- run: pnpm turbo typecheck
24+
25+
test:
26+
runs-on: ubuntu-latest
27+
needs: lint-and-typecheck
28+
steps:
29+
- uses: actions/checkout@v4
30+
- uses: pnpm/action-setup@v3
31+
with:
32+
version: 10
33+
- uses: actions/setup-node@v4
34+
with:
35+
node-version: 22
36+
cache: pnpm
37+
- run: pnpm install --frozen-lockfile
38+
- run: pnpm turbo test
39+
- name: Upload coverage
40+
uses: actions/upload-artifact@v4
41+
with:
42+
name: coverage
43+
path: packages/*/coverage/
44+
45+
build:
46+
runs-on: ubuntu-latest
47+
needs: test
48+
steps:
49+
- uses: actions/checkout@v4
50+
- uses: pnpm/action-setup@v3
51+
with:
52+
version: 10
53+
- uses: actions/setup-node@v4
54+
with:
55+
node-version: 22
56+
cache: pnpm
57+
- run: pnpm install --frozen-lockfile
58+
- run: pnpm turbo build

0 commit comments

Comments
 (0)