Git repositories may be contained in a .git directory or a .git file
in the workdir hierarchy, but Atom only recognizes the directory format.
Teach Atom to recognize the filesystem-agnostic Git symbolic link
used by default in many situations including, for example, submodules.
The .git file contains a relative or absolute path to the location of
the real git-dir, preceded by the 8-byte string "gitdir: ".
Here's a console log showing the normal creation of such a symbolic link.
/tmp $ git init --separate-git-dir foo.git bar
Initialized empty Git repository in /tmp/foo.git/
/tmp $ ls
/tmp $ bar foo.git
/tmp $ ls -la bar
drwxr-xr-x 2 hordp hordp 4096 Sep 18 15:54 .
drwxr-xr-x 4 hordp hordp 4096 Sep 18 15:54 ..
-rw-r--r-- 1 hordp hordp 25 Sep 18 15:54 .git
/tmp $ ls foo.git
branches config description HEAD hooks info objects refs
/tmp $ cat bar/.git
gitdir: /tmp/foo.git
Fixes #8876
Atom is a hackable text editor for the 21st century, built on Electron, and based on everything we love about our favorite editors. We designed it to be deeply customizable, but still approachable using the default configuration.
Visit atom.io to learn more or visit the Atom forum.
Follow @AtomEditor on Twitter for important announcements.
This project adheres to the Contributor Covenant 1.2. By participating, you are expected to uphold this code. Please report unacceptable behavior to atom@github.com.
Documentation
If you want to read about using Atom or developing packages in Atom, the Atom Flight Manual is free and available online, along with ePub, PDF and mobi versions. You can find the source to the manual in atom/docs.
The API reference for developing packages is also documented on Atom.io.
Installing
OS X
Download the latest Atom release.
Atom will automatically update when a new release is available.
Windows
Download the latest AtomSetup.exe installer.
Atom will automatically update when a new release is available.
You can also download an atom-windows.zip file from the releases page.
The .zip version will not automatically update.
Using chocolatey? Run cinst Atom to install
the latest version of Atom.
Debian Linux (Ubuntu)
Currently only a 64-bit version is available.
- Download
atom-amd64.debfrom the Atom releases page. - Run
sudo dpkg --install atom-amd64.debon the downloaded package. - Launch Atom using the installed
atomcommand.
The Linux version does not currently automatically update so you will need to repeat these steps to upgrade to future releases.
Red Hat Linux (Fedora 21 and under, CentOS, Red Hat)
Currently only a 64-bit version is available.
- Download
atom.x86_64.rpmfrom the Atom releases page. - Run
sudo yum localinstall atom.x86_64.rpmon the downloaded package. - Launch Atom using the installed
atomcommand.
The Linux version does not currently automatically update so you will need to repeat these steps to upgrade to future releases.
Fedora 22+
Currently only a 64-bit version is available.
- Download
atom.x86_64.rpmfrom the Atom releases page. - Run
sudo dnf install atom.x86_64.rpmon the downloaded package. - Launch Atom using the installed
atomcommand.
The Linux version does not currently automatically update so you will need to repeat these steps to upgrade to future releases.
