Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/coauthors/coauthors

Easier to share ideas
https://github.com/coauthors/coauthors

cli coauthor coauthors commit git github husky prepare-commit-msg vscode-extension

Last synced: 26 days ago
JSON representation

Easier to share ideas

Host: GitHub
URL: https://github.com/coauthors/coauthors
Owner: coauthors
License: mit
Created: 2024-04-11T06:34:00.000Z (7 months ago)
Default Branch: main
Last Pushed: 2024-08-18T16:14:01.000Z (3 months ago)
Last Synced: 2024-10-04T22:03:08.374Z (about 1 month ago)
Topics: cli, coauthor, coauthors, commit, git, github, husky, prepare-commit-msg, vscode-extension
Language: TypeScript
Homepage: https://coauthors.me
Size: 5.08 MB
Stars: 51
Watchers: 0
Forks: 5
Open Issues: 12
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        


  

    

    Coauthors

  





[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg?style=for-the-badge&color=000&labelColor=000)](https://github.com/coauthors/coauthors/blob/main/LICENSE) [![npm version](https://img.shields.io/npm/v/@coauthors/core?color=000&labelColor=000&logo=npm&label=&style=for-the-badge)](https://www.npmjs.com/package/@coauthors/core) [![npm](https://img.shields.io/npm/dm/@coauthors/core?color=000&labelColor=000&style=for-the-badge)](https://www.npmjs.com/package/@coauthors/core)

[![Coauthors friendly](https://img.shields.io/badge/Coauthors-friendly-blue.svg)](http://coauthors.me) [![codecov](https://codecov.io/gh/coauthors/coauthors/branch/main/graph/badge.svg?token=H4VQ71NJ16)](https://codecov.io/gh/coauthors/coauthors) ![GitHub stars](https://img.shields.io/github/stars/coauthors/coauthors?style=social) ![GitHub forks](https://img.shields.io/github/forks/coauthors/coauthors?style=social)



## GitHub App

[Intall Coauthors GitHub App](https://github.com/apps/coauthors)

![Coauthors GitHub App](https://raw.githubusercontent.com/coauthors/coauthors/main/docs/coauthors.me/public/img/github-app-example.png)

## Git Hook with Husky

1. Setup with husky

   ```shell

   # .husky/prepare-commit-msg

   npx coauthors

   ```

2. Commit with coauthors simply

   ```shell

   git commit -m "chore: update

   coauthors: manudeli, 2-NOW(Whale)"

   ```

3. Commit message with coauthors prepare-commit-msg

   ```text

   chore: update

   Co-authored-by: Jonghyeon Ko <[email protected]>

   Co-authored-by: Whale <[email protected]>

   ```

### `coauthors -m`: CLI to get commit message with coauthors

1. With coauthors

   ```shell

   npx coauthors -m "chore: update

   coauthors: manudeli, 2-NOW(Whale)"

   ```

   ```text

   chore: update

   Co-authored-by: Jonghyeon Ko <[email protected]>

   Co-authored-by: Whale <[email protected]>

   ```

2. Without coauthors

   ```shell

   npx coauthors -m "chore: update"

   ```

   ```text

   chore: update

   ```

## Coauthors Generator

[Enter coauthors.me/generator](https://coauthors.me/generator)

[![Coauthors Generator](https://raw.githubusercontent.com/coauthors/coauthors/main/docs/coauthors.me/public/img/generator-example.gif)](https://coauthors.me/generator)

## VSCode Extension

1. Icon on source control to add coauthor string easily

   [![Coauthors VSCode Extension Example 1](https://raw.githubusercontent.com/coauthors/coauthors/main/assets/example-vscode-extension-1.png)](https://coauthors.me)

2. Status bar item to use Coauthors generator easily

   [![Coauthors VSCode Extension Example 2](https://raw.githubusercontent.com/coauthors/coauthors/main/assets/example-vscode-extension-2.png)](https://coauthors.me)

## Contributing

Read our [Contributing Guide](./CONTRIBUTING.md) to familiarize yourself with Coauthors's development process, how to suggest bug fixes and improvements, and the steps for building and testing your changes.

### Contributors

[![contributors](https://contrib.rocks/image?repo=coauthors/coauthors)](https://github.com/coauthors/coauthors/graphs/contributors)




## License

MIT © Coauthors. See [LICENSE](./LICENSE) for details.



  

    

      

      ^Coauthors