https://github.com/pleaseai/asana
asana
https://github.com/pleaseai/asana
Last synced: 5 months ago
JSON representation
asana
- Host: GitHub
- URL: https://github.com/pleaseai/asana
- Owner: pleaseai
- Created: 2025-10-24T12:56:29.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-10-24T16:31:39.000Z (8 months ago)
- Last Synced: 2025-10-24T17:19:56.285Z (8 months ago)
- Language: TypeScript
- Homepage: https://asana-pied.vercel.app
- Size: 882 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Asana CLI
[](https://github.com/pleaseai/asana/actions/workflows/ci.yml)
[](https://codecov.io/gh/pleaseai/asana)
[](https://opensource.org/licenses/MIT)
Manage your Asana tasks efficiently from the command line.
> **English** | [한국어](./README.ko.md)
## Features
- ✅ OAuth 2.0 and Personal Access Token authentication
- ✅ Create, list, complete, and delete tasks
- ✅ Automatic token refresh (OAuth)
- ✅ Default workspace configuration
- ✅ Fast execution powered by Bun
- ✨ **Multiple output formats** (TOON, JSON, Plain) for different use cases
## Quick Installation
### Homebrew (macOS/Linux - Recommended)
```bash
brew install pleaseai/tap/asana-cli
```
### Install Script (All Platforms)
```bash
curl -fsSL https://raw.githubusercontent.com/pleaseai/asana/main/scripts/install.sh | bash
```
**Note:** Add `~/.local/bin` to your PATH if needed.
### From Source
```bash
git clone https://github.com/pleaseai/asana.git
cd asana
bun install
bun run dev --help
```
## Quick Start
### Authenticate
```bash
# Using Personal Access Token (recommended)
asana auth login --token YOUR_TOKEN
# Using OAuth 2.0
asana auth login
```
### Manage Tasks
```bash
# Create a task
asana task create -n "New task" -w WORKSPACE_ID
# List your tasks
asana task list -a me -w WORKSPACE_ID
# Complete a task
asana task complete TASK_ID
```
### Output Formats
Choose output format based on your needs:
```bash
# TOON format (default) - 30-60% more token-efficient for LLMs
asana task list -a me
# JSON format - for scripts and automation
asana task list -a me --format json
# Plain format - traditional human-readable output
asana task list -a me --format plain
```
**Format Comparison:**
| Format | Use Case | Token Efficiency | Machine Readable |
| --------- | --------------------------------- | ---------------- | ---------------- |
| **TOON** | LLM interactions, sharing outputs | ⭐⭐⭐⭐⭐ | ✅ |
| **JSON** | Scripts, automation, parsing | ⭐⭐⭐ | ✅ |
| **Plain** | Terminal viewing, traditional CLI | ⭐⭐ | ❌ |
📊 Example Outputs
**TOON Format** (default):
```
tasks[3]{gid,name,completed}:
"1234567890",Setup authentication,true
"1234567891",Add task commands,false
"1234567892",Write documentation,false
```
**JSON Format**:
```json
{
"tasks": [
{ "gid": "1234567890", "name": "Setup authentication", "completed": true },
{ "gid": "1234567891", "name": "Add task commands", "completed": false },
{ "gid": "1234567892", "name": "Write documentation", "completed": false }
]
}
```
**Plain Format**:
```
Tasks (3):
✓ 1234567890 - Setup authentication
○ 1234567891 - Add task commands
○ 1234567892 - Write documentation
```
## Documentation
**[📖 Full Documentation](https://asana.pleaseai.dev/)**
- [Getting Started](https://asana.pleaseai.dev/en/guide/getting-started) - Installation and setup
- [Quick Start](https://asana.pleaseai.dev/en/guide/quick-start) - Basic commands and workflows
- [Authentication](https://asana.pleaseai.dev/en/features/authentication) - OAuth and PAT setup
- [Task Management](https://asana.pleaseai.dev/en/features/task-management) - Full task operations
- [Configuration](https://asana.pleaseai.dev/en/features/configuration) - Advanced settings
## Updating
### Homebrew
```bash
brew upgrade asana-cli
```
### Install Script
```bash
asana self-update
```
## Development
```bash
# Clone and install
git clone https://github.com/pleaseai/asana.git
cd asana
bun install
# Run in development mode
bun run dev auth login --token YOUR_TOKEN
# Run tests
bun test
# Build executable
bun run build
```
For detailed development guides, see [dev-docs/](./dev-docs/).
## Tech Stack
- **Runtime**: [Bun](https://bun.sh)
- **SDK**: [Asana Node.js SDK](https://github.com/Asana/node-asana)
- **CLI Framework**: [Commander.js](https://github.com/tj/commander.js)
- **Output Format**: [TOON](https://github.com/johannschopplich/toon) - Token-efficient format for LLMs
- **Styling**: [Chalk](https://github.com/chalk/chalk)
## License
MIT
## Author
Minsu Lee ([@amondnet](https://github.com/amondnet))