Set up private GitHub repos and push commits quickly
npm install @frycz/atmIn the era of AI tools, drafting new ideas is easier than ever. atm helps you set up private GitHub repos for your ideas and save iterations quickly.
With a single atm init command, the tool prepares a private repository. Develop your project by adding changes and quickly pushing them with atm s. That's it.
No need to visit github.com to create a private repo and set it up locally. No need for "add" -> "commit" -> "push" repetitive flow.
``bash`Global installation (recommended)
bun install -g @frycz/atmor
npm install -g @frycz/atm
Alternatively, you can use bunx or npx
`bash`
bunx @frycz/atmor
npx @frycz/atmlater remember
bunx @frycz/atm [command]or
npx @frycz/atm [command]
- Node.js >= 14
- GitHub CLI (gh) installed and authenticated
`bashCreate a new private GitHub repo
atm init repo-name
Commands
$3
1. Create a private repository on GitHub
2. Initialize a local git repository with a README
3. Push the initial commit
$3
Initialize a new private GitHub repository in interactive mode. This command will:
1. Prompt for your GitHub username (auto-detected from
gh)
2. Prompt for a repository name
3. Prompt for a local directory (defaults to ./)
4. Create a private repository on GitHub
5. Initialize a local git repository with a README
6. Push the initial commit`bash
$ atm init
GitHub username [yourname]:
Repository name: my-project
Directory [./my-project]:Creating private repo yourname/my-project...
Initializing git...
Pushing to GitHub...
Done! Repository created at /path/to/my-project
`#### Using
atm init in an existing repositoryIf you run
atm init inside an existing git repository, it will detect this and offer to create only the atm.json configuration file. This is useful when you want to start using atm with a project that already has a GitHub remote set up.`bash
$ cd existing-project
$ atm initGit repository detected in: /path/to/existing-project
Remote URL: git@github.com:yourname/existing-project.git
Host: github
Visibility: private
This will only create an atm.json file. No new repository will be created.
Create atm.json in this directory? [y/N]: y
atm.json created successfully.
You can now use 'atm s' to save and push changes.
`$3
Quick save - stages all changes, commits with the default message from config, and pushes to origin.
`bash
atm s
`$3
Stages all changes, commits with your custom message, and pushes to origin.
`bash
atm s fix login bug
atm s add user authentication
`$3
Print help.
`bash
atm -h
`$3
Print version.
`bash
atm -v
`Configuration
After running
atm init, a atm.json file is created in your repository containing:`json
{
"defaultCommitMessage": "save"
}
`You can change the default commit message used by
atm s by editing this file.Troubleshooting
$3
Install the GitHub CLI from https://cli.github.com/
macOS:
`bash
brew install gh
`Windows:
`bash
winget install GitHub.cli
`Linux:
`bash
Debian/Ubuntu
sudo apt install ghFedora
sudo dnf install gh
`$3
Run the following command and follow the prompts:
`bash
gh auth login
`$3
You need to initialize the repository first:
`bash
atm init
`FAQ
Q: What does "atm" stand for?
A: It's "all to main".
Q: Can I tell my friend about
atm`?MIT