A first session
One piece of work from start to end. This page assumes ecc is installed and ecc-global-map is on C-c c.
Start a session
Section titled “Start a session”Open a file of the project and press C-c c c. The session opens beside the file, named after the project directory. Its directory cannot change once it has started, so start from a buffer of the right project.
The session buffer has the transcript at the top and the prompt region at the bottom. The transcript is read-only, so single keys there are commands: n and p move between headings, TAB folds. In the prompt region you type as usual.
Send a prompt
Section titled “Send a prompt”Type in the prompt region and press C-c C-c; RET inserts a newline. The answer streams into the transcript. A prompt you send while Claude is working waits in a queue.
To include code, write @region or @cursor in the prompt, or send the region from the file with C-c c ? then g. See Sending from your code.
Allow a permission
Section titled “Allow a permission”A new session starts in the default permission mode, unless ecc-permission-mode or your Claude Code settings say otherwise. There, before Claude edits a file or runs a command, the transcript shows the request with its diff or command, and the session’s tab blinks until you answer.
Press a on the request to allow it once, or d to deny it. In the prompt region the same is C-c C-a and C-c C-d, and from any buffer C-c c a and C-c c d. Permissions and plans covers the other answers, such as editing the proposal first.
Review the changes
Section titled “Review the changes”C-c c D D shows everything the session changed as one diff. Press c on a line to comment on it, and C-c C-c to send all the comments to Claude as one prompt. See Reviewing changes.
F in the transcript jumps to the Files section, which lists every file the session touched.
Finish
Section titled “Finish”C-c c ? then k stops the session and kills its buffer. The conversation stays on disk, and C-c c r resumes it later, in Emacs or in the terminal client.
Each project has a tab of its own, called a Space. A day in a Space follows a piece of work through one.