# raea project

> Make a project in the workspace, list them, or move one between inline and a repository of its own.

A project is one piece of work in a workspace: its folder, `brief.ts`, `media/` and `out/`. In the raea app it shows
as a channel. `split` turns an inline project into a repository of its own (a submodule) with its history, and
`join` brings it back.

```sh
raea project new spring-launch
raea project new big-shoot --storage submodule
raea project split spring-launch --remote git@github.com:acme/spring-launch.git
raea project join spring-launch
raea project --json
```


## Usage

```sh
raea project new NAME [--storage inline|submodule] | raea project split NAME [--remote URL] | raea project join NAME | raea project [--json]   (a project in the workspace: its folder, brief.ts, media/, out/; split and join keep its history)
```

Headless: it needs nothing running and opens no window. Takes up to 2 arguments besides its flags.

## Flags

| Flag | Takes | What it does |
| --- | --- | --- |
| `--json` | – | Print the workspace's projects as JSON: name, path and storage. |
| `--remote` | `URL` | With `split`: the git remote the new repository pushes to. |
| `--storage` | `inline\|submodule` | With `new`: a folder in the workspace (`inline`) or a repository of its own (`submodule`); the workspace's layout decides by default. |