{"id":16062828,"url":"https://github.com/schpet/stories","last_synced_at":"2026-02-09T00:34:14.363Z","repository":{"id":142348463,"uuid":"605426557","full_name":"schpet/stories","owner":"schpet","description":"Pivotal Tracker CLI for people that deliver stories","archived":false,"fork":false,"pushed_at":"2023-07-13T21:21:42.000Z","size":127,"stargazers_count":3,"open_issues_count":6,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-02T18:17:32.744Z","etag":null,"topics":["cli","pivotal-tracker"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/schpet.png","metadata":{"files":{"readme":"README.markdown","changelog":"CHANGELOG.markdown","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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-02-23T05:59:38.000Z","updated_at":"2023-09-30T10:01:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"fa0cd3f9-e26d-408b-b609-c298656cca1e","html_url":"https://github.com/schpet/stories","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/schpet/stories","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schpet%2Fstories","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schpet%2Fstories/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schpet%2Fstories/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schpet%2Fstories/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/schpet","download_url":"https://codeload.github.com/schpet/stories/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schpet%2Fstories/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269548500,"owners_count":24436113,"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-08-09T02:00:10.424Z","response_time":111,"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":["cli","pivotal-tracker"],"created_at":"2024-10-09T05:00:21.066Z","updated_at":"2026-02-09T00:34:09.325Z","avatar_url":"https://github.com/schpet.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Stories\n\nstories is a cli client for pivotal tracker for all the story delivery people out there.\n\ndrop a `stories.json` file in your project, and voila, you can quickly see your work, start stories, and generate summaries of recent work done.\n\nsome commands it offers:\n\n```bash\n# equivalent to tracker's \"My work\" tab\nstories mine\n\n# checks out a branch for a story, and marks it as started\nstories branch 12345\n\n# print a story to stdout, based on the git branch\nstories view\n\n# or, open the website\nstories view --web\n\n# you can pass an id instead of git branch\nstories view 12345\n\n# show a report of recent changes you've made to stories\nstories activity\n\n# show all of the commands\nstories --help\n```\n\n\n## Installation\n\nHomebrew (mac):\n\n```sh\nbrew install schpet/tap/stories\n```\n\nLinux and mac binaries also available on [releases](https://github.com/schpet/stories/releases)\n\nCargo (from source):\n\n```\n# in this project's dir\ncargo install --path .\n```\n\nthrow `alias s=stories` in your ~/.zshrc ~/.bashrc for good measure.\n\n## Setup\n\n1. get your api token at https://www.pivotaltracker.com/profile#api\n2. write this token into a file at ~/.config/stories/tracker_api_token.txt, e.g.\n   ```bash\n   mkdir -p ~/.config/stories\n   echo $YOUR_TRACKER_API_TOKEN \u003e ~/.config/stories/tracker_api_token.txt\n   ```\n3. drop a `stories.json` file in your project directory with a tracker project id, e.g.\n   ```json\n   { \"project_id\": 1234 }\n   ```\n## Github integration\n\nEnsure that your pivotal tracker project is setup with the [github integration][tgh] which connects pull requests to tracker stories, and lets you deliver stories [via commit messages][tghc].\n\nAdditionally, stories' pull-request command, e.g. \n\n```bash\nstories pr title --summarize\n```\n\nare intended to be used with github's [gh cli][gh], e.g.\n\n```\ngh pr create --title \"$(stories pr title --summarize)\" --body \"$(stories pr body)\" --web\n\n# alias this for convenience:\ngh alias set --shell prt \"gh pr create --title \\\"\\$(stories pr title --summarize)\\\" --body \\\"\\$(stories pr body)\\\" --web\"\n```\n\nyou will also want to configure your repo's settings the following way:\n\n- [ ] Allow merge commits _(optionally disable this)_\n- [x] Allow squash merging\n   - Default to pull request title and description\n- [ ] Allow rebase merging  _(optionally disable this)_\n\nthis can be done through the github repo settings page, or via `gh api`:\n\n```bash\ngh api repos/{owner}/{repo} --method PATCH -f allow_squash_merge=true -f allow_merge_commit=false -f allow_rebase_merge=false -f squash_merge_commit_title=PR_TITLE -f squash_merge_commit_message=PR_BODY\n```\n\n[tgh]: https://www.pivotaltracker.com/help/articles/github_integration/\n[tghc]: https://www.pivotaltracker.com/help/articles/github_integration/#using-the-github-integration-commits\n[gh]: https://cli.github.com/\n\n\n## Development\n\n### Releasing a new version\n\n```console\ncargo release -x patch\ncargo release -x minor\ncargo release -x major\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fschpet%2Fstories","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fschpet%2Fstories","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fschpet%2Fstories/lists"}