🦅 Kujto

Stop re-teaching your AI agents every session.

Versioned, bilingual memory for Claude, Codex, Gemini, Copilot & Cursor. Memorie e versionuar, dygjuheshe per Claude, Codex, Gemini, Copilot & Cursor.

🇦🇱 Shqip · 🇬🇧 English · Mburoja · Site · Memory · Tools · Roadmap

Teach your AI once. It remembers forever. Your coding agents shouldn't need a re-orientation every chat. Kujto is the missing memory layer: a structured, versioned Markdown brain that Claude, Codex, Gemini, Copilot and Cursor all read on every run.

🇦🇱 Shqip

Pse Kujto ekziston

Cdo bisede e re me Claude, Codex, Gemini, ose Copilot fillon nga zero. Ti shpenzon kohe duke i ri-mesuar konventat, arkitekturen, stilin, rregullat e git-it. Kujto e mban ate dije ne memory/ te repo-s tende: file Markdown te strukturuar, te versionuar, qe cdo agjent i lexon ne cdo sesion.

Pa abonime. Pa lock-in. Pa magji. Vetem markdown.

Çfarë merr sot

🧠 Memory framework dygjuhesh (shqip dhe anglisht ne te njejtin file), me rregulla berthame, konventa iOS, dhe workflow.
🏛 12 guida arkitekture iOS per MVC, MVP, MVVM, MVVM-C, VIPER, Clean Swift, Clean Architecture, TCA, Redux, ReactorKit, RIBs, MV + @Observable. Plus nje guide vendimi.
🛡 Mburoja - playbook i plote sigurie per aplikacionet web (XSS, CSRF, SSRF, SQLi, XXE, JWT, file upload, path traversal, dhe me shume). 15 file, dygjuhesh.
🤝 Nje burim, pese agjente. Claude, Codex, Gemini, Copilot, Cursor lexojne te njejtin AGENTS.md permes symlink-eve.
⚡ Vegla zero-config: simulator.sh ndez cdo projekt Xcode pa pyetje. wire.sh e lidh Kujto-n ne cdo repo me dy komanda.
🌐 Faqe e gjalle te kujto.peterdsp.dev me zbulim automatik gjuhe (shqip per Shqiperi, Kosove, Maqedoni e Veriut).

Instalim me nje rresht

curl -fsSL https://raw.githubusercontent.com/peterdsp/kujto/main/bin/install.sh | bash

Quickstart

# 1. Lidh Kujto-n te projekti yt
cd path/to/your/project
~/kujto/wire.sh

# 2. (iOS) ndez app pa konfigurim
~/kujto/simulator.sh

Tani agjentet e tu lexojne AGENTS.md dhe ndjekin memory/MEMORY.md ne cdo sesion. Asnje brifing me.

🇬🇧 English

Why Kujto exists

Every fresh chat with Claude, Codex, Gemini, or Copilot starts from zero. You burn minutes (and tokens) re-teaching it your conventions, architecture, style, git rules. Kujto keeps that knowledge in your repo's memory/: structured, versioned Markdown that every agent reads in every session.

No subscriptions. No lock-in. No magic. Just markdown.

What you get today

🧠 Bilingual memory framework (Albanian and English in the same file), with core rules, iOS conventions, and workflows.
🏛 12 iOS architecture guides covering MVC, MVP, MVVM, MVVM-C, VIPER, Clean Swift, Clean Architecture, TCA, Redux, ReactorKit, RIBs, MV + @Observable. Plus a decision guide.
🛡 Mburoja - a full web-security playbook (XSS, CSRF, SSRF, SQLi, XXE, JWT, file upload, path traversal, and more). 15 files, bilingual.
🤝 One source, five agents. Claude, Codex, Gemini, Copilot, Cursor read the same AGENTS.md via symlinks.
⚡ Zero-config tools: simulator.sh boots any Xcode project, no questions asked. wire.sh attaches Kujto to any repo in two commands.
🌐 Live site at kujto.peterdsp.dev with auto-language detection (Albanian for Albania, Kosovo, North Macedonia).

One-line install

curl -fsSL https://raw.githubusercontent.com/peterdsp/kujto/main/bin/install.sh | bash

Quickstart

# 1. Wire Kujto into your project
cd path/to/your/project
~/kujto/wire.sh

# 2. (iOS) boot the app, no config
~/kujto/simulator.sh

Your agents now read AGENTS.md and follow memory/MEMORY.md in every session. No more briefings.

Mburoja, security playbook

🛡 Mburoja (shqip per shield) eshte playbook i sigurise se Kujto-s per aplikacione web. 15 file dygjuhesh qe agjentet i lexojne kur shkruan ose rishikojne kod web, ose kur kerkon nje audit eksplicit.

🛡 Mburoja (Albanian for shield) is Kujto's web-security playbook. 15 bilingual files your agents read when writing or reviewing web code, or when you explicitly ask for an audit.

Coverage / Mbulimi:

Client-side	Server-side	Tokens & APIs
Access control	SSRF	JWT
XSS	File upload	API security
CSRF	SQL injection	Security headers
Secrets exposure	XXE
Open redirect	Path traversal
Password security

Trigger / Aktivizimi: thuaji agjentit "audit me Mburoja" ose "mburoja review", para shkrimit te kodit te ri ose para merge te PR-ve qe prekin auth, upload, redirect, query string.

Tell your agent "audit with Mburoja" or "mburoja review", before writing new code or before merging PRs that touch auth, upload, redirect, or query strings.

Site

Kujto ka nje faqe statike te gjalle / Kujto has a live static site at kujto.peterdsp.dev.

E ndertuar me HTML dhe CSS te paster, pa framework, pa build step.
Dygjuheshe me zbulim automatik vendndodhjeje (IP-based) per vizitore nga Shqiperia, Kosova dhe Maqedonia e Veriut.
Buton notues (FAB) ne kend te poshtem te djathte per nderrimin manual te gjuhes.
E publikuar automatikisht me GitHub Pages nga dosja site/.

Built with plain HTML and CSS, no framework, no build step. Bilingual with automatic geo-detection (IP-based) for visitors from Albania, Kosovo, and North Macedonia. A floating action button in the bottom-right corner lets users switch languages manually. Auto-deployed via GitHub Pages from the site/ directory.

site/
├── index.html      faqja kryesore me i18n te integruar / main page with inline i18n
├── styles.css       stilet / styles
├── favicon.svg      ikona / favicon
└── CNAME            kujto.peterdsp.dev

Memory

The memory base is the heart of the project. It lives in memory/ and follows this reading order:

AGENTS.md at the root (rules for every agent, bilingual).
memory/MEMORY.md (the index).
Only the referenced files relevant to the task.

Layout

memory/
├── MEMORY.md                       indeks dygjuhesh / bilingual index
├── core/
│   ├── writing_style.md            stil i shkrimit, rregulli no-em-dash
│   ├── safety_and_git.md           siguri dhe disipline git
│   └── handoff.md                  ruajtja e gjendjes ne limit konteksti
├── domains/
│   ├── ios/                        iOS first
│   │   ├── swift_conventions.md
│   │   ├── xcode_workflow.md
│   │   ├── snapshot_testing.md
│   │   ├── navigation.md
│   │   └── architectures/          12 modele arkitekture / 12 patterns
│   └── web/                        🛡 Mburoja, siguria web / web security
│       ├── README.md
│       ├── access_control.md
│       ├── xss.md
│       ├── csrf.md
│       ├── ssrf.md
│       ├── sql_injection.md
│       ├── jwt.md
│       └── ... (15 file gjithsej / 15 files total)
└── workflows/
    ├── answer_order.md
    ├── pr_descriptions.md
    └── git_hygiene.md

Detaje në docs/memory-architecture.md.

Tools

Vegla qe shoqerojne memorien / Tools that ship with the memory:

`simulator.sh`

Zero-config për çdo projekt iOS Xcode.

./simulator.sh                       # auto-detect everything
./simulator.sh --device "iPhone 15"  # pin a device
./simulator.sh --scheme MyApp        # pin a scheme
./simulator.sh --clean               # rebuild from scratch
./simulator.sh --list                # list schemes and devices
./simulator.sh --no-logs             # do not stream logs
./simulator.sh --stop                # terminate app and shutdown sim

Detaje në docs/simulator-guide.md.

`wire.sh`

Lidh Kujto-n ne cdo repo me nje komande / Attach Kujto to any repo in one command:

~/kujto/wire.sh

Integrations

Agent	Wires into	Folder
Claude Code	`~/.claude/CLAUDE.md`	`integrations/claude/`
OpenAI Codex CLI	`~/.codex/AGENTS.md`	`integrations/codex/`
Gemini CLI	`~/.gemini/GEMINI.md`	`integrations/gemini/`
GitHub Copilot	`.github/copilot-instructions.md`	`integrations/copilot/`
Cursor	`.cursor/rules/kujto.mdc`	`integrations/cursor/`

Te peste lexojne te njejtin AGENTS.md permes symlink-eve. One source of truth.

Philosophy

Memorie e versionuar, jo memorie chat-i. / Versioned memory, not chat memory.
iOS pari, ne thelle, jo gjeresisht. / iOS first, deep before wide.
Zero config fiton. / Zero config wins.
Dygjuhesh eshte identitet. / Bilingual is identity. Shqipja e para. Albanian first.
Mburoja qe ne fillim. / Security from day one. Mburoja covers what most starter kits forget.

Releases

Versioni aktual / Current version: v0.1.3. Shiko / See GitHub Releases.

Packages

Kujto ka siperfaqe fillestare package per SwiftPM, KMP/Gradle dhe Flutter/Dart. Publikimi lidhet me release-et.

Kujto has initial package surfaces for SwiftPM, KMP/Gradle, and Flutter/Dart. Publishing is tied to releases.

SwiftPM

swift package resolve
swift run kujto wire --target /path/to/your/repo --memory

KMP / Gradle

plugins {
    id("com.github.peterdsp.kujto") version "0.1.3"
}

Flutter

Tooling CLI, jo runtime dependency. Tooling CLI, not a runtime dependency.

Commit distance

Çdo commit duhet të ketë një distancë logjike të qartë nga tjetri:

1 qëllim për commit.
5 deri 200 rreshta diff si rregull praktik.
Ndaje commit-in kur prek dy fusha, për shembull README dhe skript runtime.
Tag release vetëm kur README, install path dhe smoke test janë në sinkron.

Each commit should have clear logical distance from the next:

1 intent per commit.
5 to 200 diff lines as a practical default.
Split when it touches two concerns (e.g. README and a runtime script).
Tag a release only when README, install path, and smoke test are aligned.

Roadmap

v0.1.3 (aktual / current)

Memory framework (core, domains/ios, workflows)
AGENTS.md + adapter per Claude, Codex, Gemini, Copilot, Cursor
simulator.sh me auto-detektim te plote
wire.sh per integrim me repo
CI me shellcheck, no-em-dash guard, bilingual sections guard
Faqe statike e gjalle te kujto.peterdsp.dev
Perkthim i plote ne shqip me zbulim automatik vendndodhjeje
🛡 Mburoja, playbook i plote sigurie web (15 file)

v0.2 (ne vijim / next)

Pasurim i memory/domains/ios/: SwiftUI patterns, performance, accessibility, testing
snapshots.sh per regjistrim batch te snapshot-eve
xcode-cleanup.sh per DerivedData dhe simulator hygiene
Homebrew formula
CLI i vetem kujto per te gjitha veglat
Mburoja v2: OAuth flows, GraphQL deep dive, rate limiting, supply-chain

Me tej / Later

memory/domains/android/ (Kotlin, Compose, Gradle)
memory/domains/backend/ (Vapor, Express, FastAPI)
memory/domains/frontend/ (React, Vue, SvelteKit)
Plugin per Xcode dhe VSCode

Contributing

PR-të janë të mirëpritura. Lexo CONTRIBUTING.md i pari. Të dyja gjuhët duhet të mbeten në sinkron në çdo file.

PRs welcome. Read CONTRIBUTING.md first. Both languages must stay in sync in every file.

License

MIT. Use it, fork it, ship it.

Nese Kujto te kurseu nje komande, lere nje ⭐

If Kujto saved you a command, drop a ⭐

Ndertuar me 🦅 ne Tirane dhe Athine nga @peterdsp. Built with 🦅 in Tirana and Athens by @peterdsp.

Name		Name	Last commit message	Last commit date
Latest commit History 20 Commits
.github		.github
Sources		Sources
Tests/KujtoCoreTests		Tests/KujtoCoreTests
bin		bin
docs		docs
examples/ios-starter		examples/ios-starter
integrations		integrations
memory		memory
packages		packages
site		site
.editorconfig		.editorconfig
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
CODEX.md		CODEX.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
GEMINI.md		GEMINI.md
LICENSE		LICENSE
Package.resolved		Package.resolved
Package.swift		Package.swift
README.md		README.md
auto-pull.sh		auto-pull.sh
auto-push.sh		auto-push.sh
install.sh		install.sh
simulator.sh		simulator.sh
wire.sh		wire.sh

Folders and files

Latest commit

History

Repository files navigation

🦅 Kujto

Stop re-teaching your AI agents every session.

🇦🇱 Shqip

Pse Kujto ekziston

Çfarë merr sot

Instalim me nje rresht

Quickstart

🇬🇧 English

Why Kujto exists

What you get today

One-line install

Quickstart

Mburoja, security playbook

Site

Memory

Layout

Tools

simulator.sh

wire.sh

Integrations

Philosophy

Releases

Packages

SwiftPM

KMP / Gradle

Flutter

Commit distance

Roadmap

v0.1.3 (aktual / current)

v0.2 (ne vijim / next)

Me tej / Later

Contributing

License

Nese Kujto te kurseu nje komande, lere nje ⭐

If Kujto saved you a command, drop a ⭐

About

Topics

Resources

License

Code of conduct

Contributing

Uh oh!

Stars

Watchers

Forks

Releases 4

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

`simulator.sh`

`wire.sh`

Packages