AI-ja e parë shqiptare e memories për dev iOS. E versionuar, dygjuhëshe, e gjallë. The first Albanian AI memory base for iOS developers. Versioned, bilingual, alive.
🇦🇱 Shqip · 🇬🇧 English · Site · Memory · Tools · Packages · Roadmap
Kujto ("kujto!" në mënyrën urdhërore) është një bazë memorie për agjentët AI që punojnë në projekte iOS. Mban të vërtetën afatgjatë (konventa Swift, modelet kryesore të arkitekturës iOS, rregulla snapshot-esh, higjienë git, stil shkrimi) në Markdown të strukturuar dhe të versionuar, jo në kontekstin e brishtë të një bisede.
Fokusi fillestar është iOS me Claude, Codex, Gemini dhe Copilot, sepse aty rri vlera më e drejtpërdrejtë: dev iOS i shqipfolur nuk ka pasur kurrë një bazë memorie në gjuhën amtare që agjentët e tij ta lexojnë në çdo sesion.
Arkitektura është bërë për t'u zgjeruar (memory/domains/), por në fillim po e dërgojmë mirë një fushë të vetme.
Si bonus, repo-ja sjell simulator.sh, një skript ultra-portativ që ndez çdo projekt Xcode pa konfigurim. Ai është vegla e parë në një familje që do të rritet bashkë me memorien.
Projekti ka tani edhe faqen e vet të gjallë te kujto.peterdsp.dev, me përkthim të plotë në shqip, ndërrues gjuhe dhe zbulim automatik vendndodhjeje (shqip si parazgjedhje për vizitorë nga Shqipëria, Kosova dhe Maqedonia e Veriut).
- Faqe statike e gjallë te kujto.peterdsp.dev, e publikuar me GitHub Pages.
- Dygjuhëshe me zbulim vendndodhjeje - faqja zbulon automatikisht vendin e vizitorit dhe shfaq shqip ose anglisht. Butoni notues lejon ndërrimin e gjuhës.
- Memory framework dygjuhësh (shqip dhe anglisht në të njëjtin file), me rregulla bërthamë, konventa iOS dhe workflow.
- 12 guida arkitekture iOS për modele klasike, UIKit, SwiftUI, reactive dhe unidirectional. Plus një guidë vendimi për të zgjedhur saktë midis tyre.
- Adapter për Claude Code, OpenAI Codex CLI, Gemini CLI, GitHub Copilot, Cursor përmes një
AGENTS.mdtë vetëm. simulator.shzero-config për ndërtim, instalim, ndezje dhe streaming log-esh në çdo projekt iOS Xcode.wire.shpër lidhjen e Kujto-s në çdo repo me dy komanda.
curl -fsSL https://raw.githubusercontent.com/peterdsp/kujto/main/bin/install.sh | bashOse lokalisht:
git clone https://github.com/peterdsp/kujto.git ~/kujto
cd ~/kujto && ./install.sh# 1. Lidh memory-në te projekti yt iOS
cd path/to/your/ios/project
~/kujto/wire.sh
# 2. Ndez app-in pa konfigurim
~/kujto/simulator.shTani agjentët e tu (Claude, Codex, Gemini, Copilot) e lexojnë AGENTS.md dhe e ndjekin memory/MEMORY.md ne çdo sesion.
Kujto ("remember!" in Albanian, imperative) is a memory base for AI agents working on iOS projects. It stores long-term truth (Swift conventions, the main iOS architecture patterns, snapshot rules, git hygiene, writing style) in structured, versioned Markdown, not in the fragile context of a single chat.
The initial focus is iOS with Claude, Codex, Gemini, and Copilot, because that is where the most direct value lives: Albanian-speaking iOS devs never had a native-language memory base their agents could pick up in every session.
The architecture is built to expand (memory/domains/), but we are shipping one domain well first.
As a bonus, the repo ships simulator.sh, an ultra-portable script that boots any Xcode project with zero config. It is the first tool in a family that will grow alongside the memory.
The project now has its own live site at kujto.peterdsp.dev, with full Albanian translation, a language switcher, and automatic geo-detection (defaults to Albanian for visitors from Albania, Kosovo, and North Macedonia).
- Live static site at kujto.peterdsp.dev, deployed via GitHub Pages.
- Bilingual with geo-detection - the site auto-detects the visitor's country and shows Albanian or English. A floating button lets users switch manually.
- Bilingual memory framework (Albanian and English in the same file), with core rules, iOS conventions, and workflows.
- 12 iOS architecture guides across classic, UIKit, SwiftUI, reactive, and unidirectional patterns. Plus a decision guide for choosing between them.
- Adapter for Claude Code, OpenAI Codex CLI, Gemini CLI, GitHub Copilot, Cursor through a single
AGENTS.md. - Zero-config
simulator.shfor building, installing, launching, and tailing logs on any iOS Xcode project. wire.shto attach Kujto to any repo with two commands.
curl -fsSL https://raw.githubusercontent.com/peterdsp/kujto/main/bin/install.sh | bashOr locally:
git clone https://github.com/peterdsp/kujto.git ~/kujto
cd ~/kujto && ./install.sh# 1. Wire memory into your iOS project
cd path/to/your/ios/project
~/kujto/wire.sh
# 2. Boot the app with zero config
~/kujto/simulator.shYour agents (Claude, Codex, Gemini, Copilot) now read AGENTS.md and follow memory/MEMORY.md in every session.
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
The memory base is the heart of the project. It lives in memory/ and follows this reading order:
AGENTS.mdat the root (rules for every agent, bilingual).memory/MEMORY.md(the index).- Only the referenced files relevant to the task.
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/ FOKUSI I FILLIMIT / INITIAL FOCUS
│ ├── swift_conventions.md
│ ├── xcode_workflow.md
│ ├── snapshot_testing.md
│ ├── navigation.md
│ └── architectures/ modele arkitekture / architecture patterns
│ ├── README.md si te zgjedhesh / how to choose
│ └── *.md guida per modelet kryesore iOS / guides
└── workflows/
├── answer_order.md
├── pr_descriptions.md
└── git_hygiene.md
Detaje në docs/memory-architecture.md.
Vegla e parë qe shoqeron memorien:
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 simDetaje në docs/simulator-guide.md.
| 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/ |
Të katërt (Claude, Codex, Gemini, Copilot) lexojnë të njëjtin AGENTS.md përmes symlink-eve. One source of truth.
- 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.
Versioni aktual: v0.1.3. Shiko te gjitha release-et te GitHub Releases.
Current version: v0.1.3. See all releases at GitHub Releases.
Kujto ka tani sipërfaqe fillestare package për SwiftPM, KMP/Gradle dhe
Flutter/Dart. Publikimi lidhet me release-et: kur publikohet një GitHub
Release, workflow Packages ndërton SwiftPM, publikon Gradle plugin në
GitHub Packages dhe bën dry-run për Flutter.
Për iOS, rruga praktike është Swift Package Manager me URL të repo-s dhe tag versioni:
swift package resolve
swift run kujto wire --target /path/to/your/repo --memoryPër KMP/Gradle, GitHub Packages është i dobishëm për plugin-in:
plugins {
id("com.github.peterdsp.kujto") version "0.1.3"
}Për Flutter, package është CLI vegle dhe duhet të shkojë në pub.dev kur të jetë gati për publikim publik. Nuk duhet të jetë runtime dependency e app-it.
Kujto now has initial package surfaces for SwiftPM, KMP/Gradle, and
Flutter/Dart. Publishing is tied to releases: when a GitHub Release is
published, the Packages workflow builds SwiftPM, publishes the Gradle plugin
to GitHub Packages, and dry-runs Flutter.
For iOS, the practical path is Swift Package Manager with the repository URL and a version tag:
swift package resolve
swift run kujto wire --target /path/to/your/repo --memoryFor KMP/Gradle, GitHub Packages is useful for the plugin:
plugins {
id("com.github.peterdsp.kujto") version "0.1.3"
}For Flutter, the package is a tooling CLI and should go to pub.dev when it is ready for public publishing. It should not be an app runtime dependency.
Ç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.
- Mos bëj commit vetëm se kaluan 10 minuta. Bëje kur ka një njësi pune që kompilon, lexohet dhe mund të kthehet mbrapsht më vete.
- 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 the commit when it touches two concerns, for example README and a runtime script.
- Do not commit just because 10 minutes passed. Commit when there is a unit of work that builds, reads cleanly, and can be reverted on its own.
- Tag a release only when README, install path, and smoke test are aligned.
- Memory framework (core, domains/ios, workflows)
- AGENTS.md + adapter per Claude, Codex, Gemini, Copilot, Cursor
-
simulator.shme auto-detektim te plote -
wire.shper integrim me repo - CI me shellcheck, no-em-dash guard, bilingual sections guard
- Faqe statike e gjalle te kujto.peterdsp.dev me GitHub Pages
- Perkthim i plote ne shqip me zbulim automatik vendndodhjeje dhe ndërrues gjuhe
- Pasurim i
memory/domains/ios/: SwiftUI patterns, performance, accessibility, testing -
snapshots.shper regjistrim batch te snapshot-eve -
xcode-cleanup.shper DerivedData dhe simulator hygiene - Homebrew formula
- CLI i vetem
kujtoper te gjitha veglat
-
memory/domains/android/(Kotlin, Compose, Gradle) -
memory/domains/backend/(Vapor, Express, FastAPI) -
memory/domains/web/(React, Vue, SvelteKit) - Plugin per Xcode dhe VSCode
PR-të janë të mirëpritura. Lexo CONTRIBUTING.md i pari. Të dyja gjuhët duhet të mbeten në sinkron në çdo file.
MIT. Use it, fork it, ship it.