{"id":13465099,"url":"https://github.com/npryce/pottery","last_synced_at":"2025-04-13T19:31:33.148Z","repository":{"id":54332215,"uuid":"145144075","full_name":"npryce/pottery","owner":"npryce","description":"It's like Twitter, for recording things that happen in your project, stored in it's version control repository.","archived":false,"fork":false,"pushed_at":"2021-10-25T15:09:34.000Z","size":62,"stargazers_count":95,"open_issues_count":5,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-27T10:13:42.126Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/npryce.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-08-17T16:37:11.000Z","updated_at":"2024-12-27T12:27:23.000Z","dependencies_parsed_at":"2022-08-13T12:20:12.995Z","dependency_job_id":null,"html_url":"https://github.com/npryce/pottery","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/npryce%2Fpottery","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/npryce%2Fpottery/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/npryce%2Fpottery/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/npryce%2Fpottery/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/npryce","download_url":"https://codeload.github.com/npryce/pottery/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248767909,"owners_count":21158557,"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","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":[],"created_at":"2024-07-31T14:00:59.386Z","updated_at":"2025-04-13T19:31:32.559Z","avatar_url":"https://github.com/npryce.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"Pottery\n=======\n\nIt's like Twitter, for recording things that happen in your project, stored in it's version control repository.\n\n[![Build Status](https://travis-ci.org/npryce/pottery.svg?branch=master)](https://travis-ci.org/npryce/pottery)\n\nIf you use JetBrains IDEs, you may find the [Pottery Idea Plugin](https://github.com/npryce/pottery-idea-plugin) more convenient.\n\nQuick Start\n-----------\n\n[Install Pottery](INSTALL.md).\n\nUse the `pottery` command to record significant events in your project with short,\nTwitter-like posts (which we've nicknamed [\"sherds\"](https://en.wikipedia.org/wiki/Sherd)).\n\nSherds are stored in a subdirectory of your project as Markdown files. \nThe default directory is `docs/project-history`, but you can specify a \ndifferent directory when you initialise the history log.\n\n1. Create a directory in the root of your project:\n\n        pottery init\n\n    This will create a directory named `docs/project-history`\n\n2. Post interesting events\n\n        pottery post Alice joined the project\n\n    This will create a new Markdown file in a dated subdirectory and file\n\twithin `docs/project-directory`.  If you don't write any text after the\n\t`post` command, Pottery will open the new file for editing in your\n    editor of choice (as specified by the VISUAL or EDITOR environment\n    variable).\n\t\n4. Post more events, when they occur.\n\n        pottery post Bob left the project\n        pottery post The company merged with MegaCorp, stopped selling widgets and started promoting doodads.\n\n    Over time, you will build a record of the non-technical influences that \n\taffected the project over its lifetime.\n\n\n3. For further information, use the built in help:\n\n        pottery help\n\n\nSee the [tests](tests/) for detailed examples.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnpryce%2Fpottery","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnpryce%2Fpottery","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnpryce%2Fpottery/lists"}