{"id":22764910,"url":"https://github.com/brackets-userland/brackets-persistent-history","last_synced_at":"2025-10-09T04:33:59.208Z","repository":{"id":33563655,"uuid":"37209907","full_name":"brackets-userland/brackets-persistent-history","owner":"brackets-userland","description":":floppy_disk: Extension that saves editing history between changing projects or closing Brackets.","archived":false,"fork":false,"pushed_at":"2023-03-18T08:45:20.000Z","size":164,"stargazers_count":9,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-25T22:55:31.615Z","etag":null,"topics":["brackets","brackets-extension"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/brackets-userland.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2015-06-10T16:50:34.000Z","updated_at":"2022-09-12T00:57:06.000Z","dependencies_parsed_at":"2023-07-18T09:14:50.888Z","dependency_job_id":null,"html_url":"https://github.com/brackets-userland/brackets-persistent-history","commit_stats":null,"previous_names":["petetnt/brackets-persistent-history"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/brackets-userland/brackets-persistent-history","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brackets-userland%2Fbrackets-persistent-history","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brackets-userland%2Fbrackets-persistent-history/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brackets-userland%2Fbrackets-persistent-history/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brackets-userland%2Fbrackets-persistent-history/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brackets-userland","download_url":"https://codeload.github.com/brackets-userland/brackets-persistent-history/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brackets-userland%2Fbrackets-persistent-history/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000702,"owners_count":26082921,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"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":["brackets","brackets-extension"],"created_at":"2024-12-11T12:10:50.569Z","updated_at":"2025-10-09T04:33:59.193Z","avatar_url":"https://github.com/brackets-userland.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Brackets Persistent History\nExtension that saves editing history between changing projects or while Brackets is closed.\n\nCreated to supplement [this Trello card (Local history versioning).](https://trello.com/c/H8AyDwFA/391-local-history-versioning)\n\n### Note\n\u003e This extension is still under work, but the basics should work. Help by filing issues, figuring out edge cases and suggesting new features!\n\n## How does it work?\n\n### Saving history\n\nWhen a file has been edited (so that it's CodeMirror history has been modified) and user saves the current file following happens:\n\n* the actual history is saved to `state.json` (key is the full path)\n* a cached version the file is saved to `modules/cache` (as `first-10-letters-of-path-converted-to-sha-1.tmp`)\n\n### Loading history\n\nWhen user opens a file, the extension checks first checks if the cache folder contains a cached copy of the file and the diff's it against the current document using `JsDiff`. This step is important, as CodeMirror history works line/character basis, which makes any changes to the document invalidate the entire history.\n\nRegardless of whether the cached version differs from the original, the extension proceeds to reinserting the history. However, if the document was modified, the extension first reverts the document to the cached version, applies the history and then returns the document to original state. This way the `redo` history get invalidated, but `undo` history works as intended:\n\n\u003e current document \u0026rarr; cached document \u0026rarr; history\n\n## Preferences\n\nFollowing configuration options are available (under `petetnt.brackets-persistent-history`):\n\n#### persistHistory (Boolean) \n\u003e Default: `true` - Enables or disables persistent history\n\n#### cacheTimeToLiveInDays (Integer)\n\u003e Default: `14` - How many days should the cache (`===` editing history + files) live. Note that working with many large files might bloat the size of the cache very quickly, so modify accordingly.\n\n## TODO\n\n- [ ] Create unit tests\n\n## Contributing\nContributions are welcome! Just open a new issue and/or send a pull request.\n\n## License \nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrackets-userland%2Fbrackets-persistent-history","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrackets-userland%2Fbrackets-persistent-history","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrackets-userland%2Fbrackets-persistent-history/lists"}