Skip to main content

acc project

Manage projects in your Accomplish workspace.

Usage​

acc project <SUBCOMMAND>

Subcommands​

SubcommandDescription
listList all projects
currentShow current default project identifier
newCreate a new project

acc project list​

List all projects in your workspace.

Usage​

acc project list

Sample Output​

┌────────────┬─────────────────────────────────┐
│ Identifier │ Name                            │
├────────────┼─────────────────────────────────┤
│ WEB        │ E-commerce Website              │
│ API        │ Backend API Service             │
│ MOB        │ Mobile Application              │
│ DOC        │ Documentation Platform          │
└────────────┴─────────────────────────────────┘

acc project current​

Show which project identifier will be used by default.

Usage​

acc project current

Sample Output​

# If project is configured
Current default project: WEB (E-commerce Website)
Source: Local configuration (.accomplish.toml)

# If no default project
No default project configured.
Use 'acc init' to set up project configuration for this directory.

acc project new​

Create a new project in your workspace.

Usage​

acc project new <NAME> [OPTIONS]

Options​

FlagDescription
-d, --description <TEXT>Optional project description
-i, --identifier <ID>Optional 3-letter identifier (auto-generated if not provided)

Examples​

# Simple project
acc project new "My Website"

# With description
acc project new "E-commerce Platform" -d "Online store with payment integration"

# With custom identifier
acc project new "API Service" -i API

# Full specification
acc project new "Mobile App" -d "iOS and Android application" -i MOB

Sample Output​

$ acc project new "Documentation Site" -d "Technical documentation platform"

Created project: Documentation Site (DOC)
Description: Technical documentation platform
Identifier: DOC

You can now use this project with:
  acc log -p DOC
  acc init  # in project directory to set as default

Project Identifiers​

Project identifiers are 3-letter codes used throughout the CLI:

  • Auto-generated: Based on project name (e.g., "My Website" → "MYW")
  • Custom: Specify with -i flag during creation
  • Unique: Each identifier must be unique in your workspace
  • Case-insensitive: "API", "api", "Api" are treated the same

Identifier Examples​

# Auto-generated identifiers
"Web Application" → "WEA"
"Backend API" → "BAC" 
"Mobile App" → "MOB"

# Custom identifiers
acc project new "Frontend" -i FE
acc project new "Database Service" -i DB

Project Context​

Projects provide context for work logging:

# Explicit project specification
acc log -m "Fixed bug" -p WEB

# Automatic project context (after acc init)
cd ~/projects/website
acc init  # configure WEB as default
acc log -m "Fixed bug"  # automatically uses WEB project

Integration with Other Commands​

Work Logging​

# List projects to see available identifiers
acc project list

# Log work to specific project
acc log -m "Updated dashboard" -p WEB

# Filter logs by project
acc logs -p API

Project Setup​

# Create project and set up directory
acc project new "My Web App" -i WEB
cd ~/projects/my-web-app
acc init  # select WEB as default project

Requirements​

  • Must be authenticated (acc login)
  • For new: Project name is required
  • For new: Identifier must be unique if specified

Best Practices​

Naming Conventions​

# Clear, descriptive names
acc project new "E-commerce Backend API"
acc project new "Customer Mobile App"
acc project new "Analytics Dashboard"

# Avoid generic names
acc project new "Project 1"          # Too generic
acc project new "Stuff"              # Not descriptive

Identifier Strategy​

# Use meaningful abbreviations
acc project new "Frontend Application" -i FE
acc project new "Backend API" -i API
acc project new "Database Service" -i DB

# Avoid confusing identifiers
acc project new "Web Service" -i WEB  # Clear
acc project new "Web Service" -i WSV  # Less clear

Workflow Integration​

# 1. Create project
acc project new "My New Project" -i MNP

# 2. Set up local directory
cd ~/code/my-new-project
acc init  # select MNP

# 3. Start logging work
acc log -m "Initial project setup"  # uses MNP automatically

Notes​

  • Projects are shared across your entire Accomplish workspace
  • Identifiers cannot be changed after creation
  • Project names can be updated through the web interface
  • Deleting projects affects all associated work log entries