{"id":50260910,"url":"https://github.com/peterdsp/kujto","last_synced_at":"2026-05-27T10:01:42.669Z","repository":{"id":359552903,"uuid":"1246601537","full_name":"peterdsp/kujto","owner":"peterdsp","description":"The first Albanian AI memory base for iOS developers. Bilingual Markdown memory for Claude, Codex, Gemini, Copilot, plus a zero-config simulator.sh. Designed to expand.","archived":false,"fork":false,"pushed_at":"2026-05-22T11:24:08.000Z","size":60,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-22T17:22:43.938Z","etag":null,"topics":["agents","ai","albania","albanian","bilingual","claude","codex","copilot","cursor","developer-tools","gemini","ios","llm","memory","simulator","swift","xcode","zero-config"],"latest_commit_sha":null,"homepage":"https://github.com/peterdsp/kujto","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/peterdsp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":"peterdsp"}},"created_at":"2026-05-22T11:04:58.000Z","updated_at":"2026-05-22T11:24:12.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/peterdsp/kujto","commit_stats":null,"previous_names":["peterdsp/kujto"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/peterdsp/kujto","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterdsp%2Fkujto","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterdsp%2Fkujto/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterdsp%2Fkujto/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterdsp%2Fkujto/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/peterdsp","download_url":"https://codeload.github.com/peterdsp/kujto/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterdsp%2Fkujto/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33560727,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-27T02:00:06.184Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","ai","albania","albanian","bilingual","claude","codex","copilot","cursor","developer-tools","gemini","ios","llm","memory","simulator","swift","xcode","zero-config"],"created_at":"2026-05-27T10:01:37.501Z","updated_at":"2026-05-27T10:01:42.664Z","avatar_url":"https://github.com/peterdsp.png","language":"Shell","funding_links":["https://github.com/sponsors/peterdsp"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🩅 Kujto\n\n**AI-ja e parĂ« shqiptare e memories pĂ«r dev iOS. E versionuar, dygjuhĂ«she, e gjallĂ«.**\n**The first Albanian AI memory base for iOS developers. Versioned, bilingual, alive.**\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Made in Albania](https://img.shields.io/badge/Made%20in-Albania%20đŸ‡ŠđŸ‡±-red)](https://github.com/peterdsp/kujto)\n[![Focus](https://img.shields.io/badge/Focus-iOS%20first-blue?logo=apple)](memory/domains/ios/)\n[![Agents](https://img.shields.io/badge/Agents-Claude%20%7C%20Codex%20%7C%20Gemini%20%7C%20Copilot-purple)](AGENTS.md)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)\n\n[đŸ‡ŠđŸ‡± Shqip](#-shqip) · [🇬🇧 English](#-english) · [Memory](#memory) · [Tools](#tools) · [Packages](#packages) · [Roadmap](#roadmap)\n\n\u003c/div\u003e\n\n---\n\n## đŸ‡ŠđŸ‡± Shqip\n\n**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.\n\nFokusi 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.\n\nArkitektura Ă«shtĂ« bĂ«rĂ« pĂ«r t'u zgjeruar (`memory/domains/`), por nĂ« fillim po e dĂ«rgojmĂ« mirĂ« njĂ« fushĂ« tĂ« vetme.\n\nSi 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.\n\n### ÇfarĂ« merr sot\n\n- **Memory framework dygjuhĂ«sh** (shqip dhe anglisht nĂ« tĂ« njĂ«jtin file), me rregulla bĂ«rthamĂ«, konventa iOS dhe workflow.\n- **12 guida arkitekture iOS** pĂ«r modele klasike, UIKit, SwiftUI, reactive dhe unidirectional. Plus njĂ« guidĂ« vendimi pĂ«r tĂ« zgjedhur saktĂ« midis tyre.\n- **Adapter pĂ«r Claude Code, OpenAI Codex CLI, Gemini CLI, GitHub Copilot, Cursor** pĂ«rmes njĂ« `AGENTS.md` tĂ« vetĂ«m.\n- **`simulator.sh` zero-config** pĂ«r ndĂ«rtim, instalim, ndezje dhe streaming log-esh nĂ« çdo projekt iOS Xcode.\n- **`wire.sh`** pĂ«r lidhjen e Kujto-s nĂ« çdo repo me dy komanda.\n\n### Instalim me njĂ« rresht\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/peterdsp/kujto/main/bin/install.sh | bash\n```\n\nOse lokalisht:\n\n```bash\ngit clone https://github.com/peterdsp/kujto.git ~/kujto\ncd ~/kujto \u0026\u0026 ./install.sh\n```\n\n### Quickstart pĂ«r dev iOS\n\n```bash\n# 1. Lidh memory-nĂ« te projekti yt iOS\ncd path/to/your/ios/project\n~/kujto/wire.sh\n\n# 2. Ndez app-in pa konfigurim\n~/kujto/simulator.sh\n```\n\nTani agjentĂ«t e tu (Claude, Codex, Gemini, Copilot) e lexojnĂ« `AGENTS.md` dhe e ndjekin `memory/MEMORY.md` ne çdo sesion.\n\n---\n\n## 🇬🇧 English\n\n**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.\n\nThe 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.\n\nThe architecture is built to expand (`memory/domains/`), but we are shipping one domain well first.\n\nAs 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.\n\n### What you get today\n\n- **Bilingual memory framework** (Albanian and English in the same file), with core rules, iOS conventions, and workflows.\n- **12 iOS architecture guides** across classic, UIKit, SwiftUI, reactive, and unidirectional patterns. Plus a decision guide for choosing between them.\n- **Adapter for Claude Code, OpenAI Codex CLI, Gemini CLI, GitHub Copilot, Cursor** through a single `AGENTS.md`.\n- **Zero-config `simulator.sh`** for building, installing, launching, and tailing logs on any iOS Xcode project.\n- **`wire.sh`** to attach Kujto to any repo with two commands.\n\n### One-line install\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/peterdsp/kujto/main/bin/install.sh | bash\n```\n\nOr locally:\n\n```bash\ngit clone https://github.com/peterdsp/kujto.git ~/kujto\ncd ~/kujto \u0026\u0026 ./install.sh\n```\n\n### Quickstart for iOS devs\n\n```bash\n# 1. Wire memory into your iOS project\ncd path/to/your/ios/project\n~/kujto/wire.sh\n\n# 2. Boot the app with zero config\n~/kujto/simulator.sh\n```\n\nYour agents (Claude, Codex, Gemini, Copilot) now read `AGENTS.md` and follow `memory/MEMORY.md` in every session.\n\n---\n\n## Memory\n\nThe memory base is the heart of the project. It lives in [`memory/`](memory/) and follows this reading order:\n\n1. [`AGENTS.md`](AGENTS.md) at the root (rules for every agent, bilingual).\n2. [`memory/MEMORY.md`](memory/MEMORY.md) (the index).\n3. Only the referenced files relevant to the task.\n\n### Layout\n\n```\nmemory/\n├── MEMORY.md indeks dygjuhesh / bilingual index\n├── core/\n│ ├── writing_style.md stil i shkrimit, rregulli no-em-dash\n│ ├── safety_and_git.md siguri dhe disipline git\n│ └── handoff.md ruajtja e gjendjes ne limit konteksti\n├── domains/\n│ └── ios/ FOKUSI I FILLIMIT / INITIAL FOCUS\n│ ├── swift_conventions.md\n│ ├── xcode_workflow.md\n│ ├── snapshot_testing.md\n│ ├── navigation.md\n│ └── architectures/ modele arkitekture / architecture patterns\n│ ├── README.md si te zgjedhesh / how to choose\n│ └── *.md guida per modelet kryesore iOS / guides\n└── workflows/\n ├── answer_order.md\n ├── pr_descriptions.md\n └── git_hygiene.md\n```\n\nDetaje nĂ« [docs/memory-architecture.md](docs/memory-architecture.md).\n\n## Tools\n\nVegla e parĂ« qe shoqeron memorien:\n\n### `simulator.sh`\n\nZero-config pĂ«r çdo projekt iOS Xcode.\n\n```bash\n./simulator.sh # auto-detect everything\n./simulator.sh --device \"iPhone 15\" # pin a device\n./simulator.sh --scheme MyApp # pin a scheme\n./simulator.sh --clean # rebuild from scratch\n./simulator.sh --list # list schemes and devices\n./simulator.sh --no-logs # do not stream logs\n./simulator.sh --stop # terminate app and shutdown sim\n```\n\nDetaje nĂ« [docs/simulator-guide.md](docs/simulator-guide.md).\n\n## Integrations\n\n| Agent | Wires into | Folder |\n|---|---|---|\n| Claude Code | `~/.claude/CLAUDE.md` | [`integrations/claude/`](integrations/claude/) |\n| OpenAI Codex CLI | `~/.codex/AGENTS.md` | [`integrations/codex/`](integrations/codex/) |\n| Gemini CLI | `~/.gemini/GEMINI.md` | [`integrations/gemini/`](integrations/gemini/) |\n| GitHub Copilot | `.github/copilot-instructions.md` | [`integrations/copilot/`](integrations/copilot/) |\n| Cursor | `.cursor/rules/kujto.mdc` | [`integrations/cursor/`](integrations/cursor/) |\n\nTĂ« katĂ«rt (Claude, Codex, Gemini, Copilot) lexojnĂ« tĂ« njĂ«jtin `AGENTS.md` pĂ«rmes symlink-eve. One source of truth.\n\n## Philosophy\n\n1. **Memorie e versionuar, jo memorie chat-i.** / Versioned memory, not chat memory.\n2. **iOS pari, ne thelle, jo gjeresisht.** / iOS first, deep before wide.\n3. **Zero config fiton.** / Zero config wins.\n4. **Dygjuhesh eshte identitet.** / Bilingual is identity. Shqipja e para. Albanian first.\n\n## Releases\n\nNuk ka release tĂ« publikuar ende. Release-i i parĂ« do tĂ« shfaqet te\n[GitHub Releases](https://github.com/peterdsp/kujto/releases) sapo tĂ«\ntag-ohet versioni i parĂ«.\n\nNo release has been published yet. The first release will appear in\n[GitHub Releases](https://github.com/peterdsp/kujto/releases) once the first\nversion is tagged.\n\n## Packages\n\nKujto ka tani sipĂ«rfaqe fillestare package pĂ«r SwiftPM, KMP/Gradle dhe\nFlutter/Dart. Publikimi lidhet me release-et: kur publikohet njĂ« GitHub\nRelease, workflow `Packages` ndĂ«rton SwiftPM, publikon Gradle plugin nĂ«\nGitHub Packages dhe bĂ«n dry-run pĂ«r Flutter.\n\nPĂ«r iOS, rruga praktike Ă«shtĂ« Swift Package Manager me URL tĂ« repo-s dhe tag\nversioni:\n\n```bash\nswift package resolve\nswift run kujto wire --target /path/to/your/repo --memory\n```\n\nPĂ«r KMP/Gradle, GitHub Packages Ă«shtĂ« i dobishĂ«m pĂ«r plugin-in:\n\n```kotlin\nplugins {\n id(\"com.github.peterdsp.kujto\") version \"0.1.3\"\n}\n```\n\nPĂ«r Flutter, package Ă«shtĂ« CLI vegle dhe duhet tĂ« shkojĂ« nĂ« pub.dev kur tĂ« jetĂ«\ngati pĂ«r publikim publik. Nuk duhet tĂ« jetĂ« runtime dependency e app-it.\n\nKujto now has initial package surfaces for SwiftPM, KMP/Gradle, and\nFlutter/Dart. Publishing is tied to releases: when a GitHub Release is\npublished, the `Packages` workflow builds SwiftPM, publishes the Gradle plugin\nto GitHub Packages, and dry-runs Flutter.\n\nFor iOS, the practical path is Swift Package Manager with the repository URL\nand a version tag:\n\n```bash\nswift package resolve\nswift run kujto wire --target /path/to/your/repo --memory\n```\n\nFor KMP/Gradle, GitHub Packages is useful for the plugin:\n\n```kotlin\nplugins {\n id(\"com.github.peterdsp.kujto\") version \"0.1.3\"\n}\n```\n\nFor Flutter, the package is a tooling CLI and should go to pub.dev when it is\nready for public publishing. It should not be an app runtime dependency.\n\n### Commit distance\n\nÇdo commit duhet tĂ« ketĂ« njĂ« distancĂ« logjike tĂ« qartĂ« nga tjetri:\n\n- 1 qĂ«llim pĂ«r commit.\n- 5 deri 200 rreshta diff si rregull praktik.\n- Ndaje commit-in kur prek dy fusha, pĂ«r shembull README dhe skript runtime.\n- Mos bĂ«j commit vetĂ«m se kaluan 10 minuta. BĂ«je kur ka njĂ« njĂ«si pune qĂ«\n kompilon, lexohet dhe mund tĂ« kthehet mbrapsht mĂ« vete.\n- Tag release vetĂ«m kur README, install path dhe smoke test janĂ« nĂ« sinkron.\n\nEach commit should have clear logical distance from the next:\n\n- 1 intent per commit.\n- 5 to 200 diff lines as a practical default.\n- Split the commit when it touches two concerns, for example README and a\n runtime script.\n- Do not commit just because 10 minutes passed. Commit when there is a unit of\n work that builds, reads cleanly, and can be reverted on its own.\n- Tag a release only when README, install path, and smoke test are aligned.\n\n## Roadmap\n\n### v0.1 (sot / today)\n\n- [x] Memory framework (core, domains/ios, workflows)\n- [x] AGENTS.md + adapter pĂ«r Claude, Codex, Gemini, Copilot, Cursor\n- [x] `simulator.sh` me auto-detektim tĂ« plotĂ«\n- [x] `wire.sh` pĂ«r integrim me repo\n- [x] CI me shellcheck, no-em-dash guard, bilingual sections guard\n\n### v0.2 (per tĂ« ardhmen e afĂ«rt / near future)\n- [ ] Pasurim i `memory/domains/ios/`: SwiftUI patterns, performance, accessibility, testing\n- [ ] `snapshots.sh` pĂ«r regjistrim batch tĂ« snapshot-eve\n- [ ] `xcode-cleanup.sh` pĂ«r DerivedData dhe simulator hygiene\n- [ ] Homebrew formula\n- [ ] CLI i vetĂ«m `kujto` pĂ«r tĂ« gjitha veglat\n\n### v1.0 (zgjerimi / expansion)\n- [ ] `memory/domains/android/` (Kotlin, Compose, Gradle)\n- [ ] `memory/domains/backend/` (Vapor, Express, FastAPI)\n- [ ] `memory/domains/web/` (React, Vue, SvelteKit)\n- [ ] Plugin pĂ«r Xcode dhe VSCode\n\n## Contributing\n\nPR-tĂ« janĂ« tĂ« mirĂ«pritura. Lexo [CONTRIBUTING.md](CONTRIBUTING.md) i pari. TĂ« dyja gjuhĂ«t duhet tĂ« mbeten nĂ« sinkron nĂ« çdo file.\n\n## License\n\n[MIT](LICENSE). Use it, fork it, ship it.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\nNdertuar me 🩅 ne Tirane dhe Athine nga [@peterdsp](https://github.com/peterdsp).\nBuilt with 🩅 in Tirana and Athens by [@peterdsp](https://github.com/peterdsp).\n\nNese Kujto te kurseu nje komande, lere nje ⭐.\nIf Kujto saved you a command, drop a ⭐.\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeterdsp%2Fkujto","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpeterdsp%2Fkujto","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeterdsp%2Fkujto/lists"}