Getting started

HachiCode is a code editor for iPhone and iPad with git built in. Clone a repository, edit with syntax highlighting and a real keyboard, stage what you want, commit, and push, all on the device. Fetching, merging, rebasing and resolving conflicts happen here too. The only network traffic is what you ask for.

This page walks the happy path. Each step links to the page with the details.

What you need

• An iPhone or iPad on a recent iOS.
• A git host: GitHub, GitLab, Gitea, Bitbucket, a self-hosted server, anything reachable over HTTPS or SSH.
• For a private repository, a credential: an access token, an OAuth sign-in, or an SSH key.
• A hardware keyboard helps for anything long. The on-screen one works, and the accessory bar makes it work better.

The Home tab

Projects are repositories. Tap + for Clone repository or New local project, which starts an empty repository on the device. The first time, the app asks for the name and email that will author your commits; change them later under Settings → Git.

Files opens the file workspace: the app's own folder, folders from other apps and iCloud Drive, single files, and folders on a server over SSH. It has the same editor and no git. See Files and folders.

Clone

Paste the URL, pick a credential if the repository is private, tap Clone. The whole history comes down, and the project opens from its card. See Cloning a repository.

Edit

A project has three modes: Editor, Git and History. In the editor, the sidebar is the file tree; tap a file to open it. Files save on their own as you type. See Editor basics for the shortcuts, search and navigation, and Tools for formatting and linting.

Commit

In the Git mode, the sidebar lists your changes as Unstaged and Staged. Stage whole files, or open Stage… on a file to pick hunks. Tap the commit button, write a title, Commit. See Committing changes.

Push

In the History mode, the push arrow opens the Push hub. Tap your branch, review the commits that go, Push. If the remote has moved on, the review says so and offers a fetch, or a force push with lease. See Push and fetch.

When the remote has changes

Fetch from the same toolbar, then in the Git mode tap Integrate to merge or rebase them into your branch. Conflicts are resolved on the device, chunk by chunk. See Merge, rebase, cherry-pick.

Free and Pro

The free plan is a full editor for the file workspace, and lets you keep one git project, read-only. Pro removes both limits: any number of projects, all writable. Everything else is the same. Upgrade from Settings → HachiCode Pro.

Where to go next

• Cloning a repository
• Access tokens, OAuth sign-in, SSH keys
• Editor basics, and the Tools for formatting and linting
• Files and folders
• Vim mode and Scripting with Lua, for keyboard-heavy editing and automation